AdnovaDocs
Creative Hub

Complete custom thumbnail

Persist the uploaded image as a custom thumbnail and attach it to the resolved File version. Call after the PUT to S3 succeeds. On success the response carries the customThumbnailId and the resolved versionId. Send this same versionId together with customThumbnail: { _id: customThumbnailId } in launch payloads under ads[].creativeDetails.creatives[], so the launcher resolves the thumbnail from the correct version.

POST
/files/{fileId}/custom-thumbnails/{uploadId}/complete

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
uploadId*string

The uploadId returned by Upload a custom thumbnail.

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/01J8ZH2M0P9Q8R7S6T5V4W3X2Y/complete" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \  -H "Content-Type: application/json" \  -d '{    "name": "poster-hero-v1.jpg",    "mime": "image/jpeg",    "size": 184672  }'
{
  "customThumbnailId": "01H8YB...",
  "fileId": "01H8YA...",
  "versionId": "V123ABC...",
  "name": "poster-hero-v1.jpg",
  "mime": "image/jpeg",
  "size": 184672,
  "thumbnailKey": "01H8Y3.../__MEDIA_CUSTOM_THUMBNAILS/01H8YB...",
  "thumbnailUrl": "https://s3.amazonaws.com/adnova-media/...?X-Amz-Signature=...",
  "status": "ready"
}
{
  "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"
}