AdnovaDocs
Creative Hub

Upload a custom thumbnail

Initiate a signed-URL upload for a custom poster image (thumbnail) for a video creative. The response carries a short-lived S3 pre-signed uploadUrl. PUT the image bytes directly to that URL (do not POST through the Adnova API), sending header Content-Disposition: attachment; filename=<filename> and a Content-Length equal to the exact size you declared here. The URL is signed for that size, so a different byte count fails with an S3 content/signature-mismatch error. After the PUT succeeds, call Complete custom thumbnail. The request is rejected with 413 if it would exceed your plan’s storage quota.

POST
/files/{fileId}/custom-thumbnails

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Path Parameters

fileId*string
Length1 <= length

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint).

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/creative-hub/v1/files/01J8ZF9K8M7N6P5R4S3T2V1W0X/custom-thumbnails" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \  -H "Content-Type: application/json" \  -d '{    "file": {      "name": "poster-hero-v1.jpg",      "mime": "image/jpeg",      "size": 184672    }  }'
{
  "uploadId": "01H8YB...",
  "uploadUrl": "https://s3.amazonaws.com/adnova-media/...?X-Amz-Signature=..."
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}