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.
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 <= 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" \ -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"
}