AdnovaDocs
Inspiration

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.

POST
/saved-ads/uploads

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

Header Parameters

x-org-id*string

Organization ULID that scopes the request.

x-workspace-id*string

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"
  }
}