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.
Authentication
authentication 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
1 <= lengthThe uploadId returned by Upload a custom thumbnail.
1 <= lengthHeader Parameters
Workspace the request operates in. Get it from List workspaces.
1 <= lengthOrganization context (required on every endpoint).
1 <= lengthRequest 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"
}