Start an inspiration upload
Step 1 of saving an inspiration from a file. Returns a pre-signed uploadUrl. PUT the file's bytes to it (directly, not through the Adnova API) with these headers — the URL is signed for them, so a mismatch fails with an S3 signature error: Content-Type: <mime>, Content-Disposition: attachment; filename=<name> (the same name declared here), and a Content-Length equal to the declared size. Then call Complete an inspiration upload. A boardId that doesn't exist or that you can't access returns 403. See Upload an inspiration.
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
Organization ULID that scopes the request.
Workspace ULID that scopes the request.
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
application/json
curl -X POST "https://api.adnova.ai/inspiration/v1/saved-ads/uploads" \ -H "x-org-id: 01K8Z23F1QQ1ZA93B8WYBS40GH" \ -H "x-workspace-id: 01KJ7S42FHQTCTKD6KKFJKTZBC" \ -H "Content-Type: application/json" \ -d '{ "boardId": "01KS80XVMDPMZQ5R83PBYA6ZR2", "file": { "name": "competitor-hook.mp4", "mime": "video/mp4", "size": 4820133 } }'{
"uploadId": "01KSG0F2W8N5X1R3T6Y9B4M7C2",
"uploadUrl": "https://example-bucket.s3.amazonaws.com/...?X-Amz-Signature=..."
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests."
}
}{
"error": {
"code": "string",
"message": "string"
}
}