Upload a file
Initiate a signed-URL upload. The response carries a short-lived S3 pre-signed uploadUrl. PUT the file 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 creative upload. Each file is capped at 1 GB, and the request is rejected with 413 if it would exceed your plan’s storage quota. For files larger than ~50 MB, prefer the multipart variant which chunks the upload.
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
Header 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" \ -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \ -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \ -H "Content-Type: application/json" \ -d '{ "boardId": "01H8YC...", "file": { "name": "creative-hero-v1.mp4", "mime": "video/mp4", "size": 1846720 } }'{
"fileId": "01H8YA...",
"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"
}