AdnovaDocs
Inspiration

Upload an inspiration

The 3-step flow for saving an image or video into a board as an inspiration.

Save your own creative — an image or a video — into an inspiration board. You upload the file directly to storage, then register it; the result is a saved ad you can fetch, search, and organize like any other.

The flow

  1. Start the upload — POST /saved-ads/uploads with the target boardId and the file's name, mime, and exact size in bytes. Returns an uploadId and a pre-signed uploadUrl. See Start an inspiration upload.
  2. Upload the file — PUT the file's bytes directly to uploadUrl (not through the Adnova API) with exactly these headers — the URL is signed for them, so any mismatch fails with an S3 SignatureDoesNotMatch error:
    • Content-Type: <mime> — the mime from step 1
    • Content-Disposition: attachment; filename=<name> — the name from step 1
    • Content-Length equal to the size from step 1
  3. Complete the upload — POST /saved-ads/uploads/{uploadId}/complete with the same boardId, name, mime, and size, plus an optional description. Adnova saves the inspiration in the board and returns it as a saved ad, with its inspirationSavedAdId. See Complete an inspiration upload.

Need a new board first? Create a board — top-level, or a sub-board with parentBoardId.

Example

# 1. Start
curl -X POST https://api.adnova.ai/inspiration/v1/saved-ads/uploads \
  -H "api-key: $API_KEY" -H "x-org-id: $ORG_ID" -H "x-workspace-id: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{ "boardId": "01KS80XVMDPMZQ5R83PBYA6ZR2", "file": { "name": "hook.mp4", "mime": "video/mp4", "size": 4820133 } }'

# 2. Upload the bytes to the returned uploadUrl
curl -X PUT "$UPLOAD_URL" -H "Content-Type: video/mp4"   -H "Content-Disposition: attachment; filename=hook.mp4" --data-binary @hook.mp4

# 3. Complete
curl -X POST https://api.adnova.ai/inspiration/v1/saved-ads/uploads/$UPLOAD_ID/complete \
  -H "api-key: $API_KEY" -H "x-org-id: $ORG_ID" -H "x-workspace-id: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{ "boardId": "01KS80XVMDPMZQ5R83PBYA6ZR2", "name": "hook.mp4", "mime": "video/mp4", "size": 4820133 }'

Notes

  • Images and videos only — mime must be an image/* or video/* type.
  • Limits: a file is capped at 1 GB and must fit your plan's storage quota, or step 1 returns 413.
  • Board access — a boardId that doesn't exist or that you can't access returns 403.
  • Complete only after the upload — calling step 3 before the file reaches uploadUrl returns 400.
  • Complete once per upload — calling step 3 again saves a second copy.
  • Thumbnails are generated in the background — thumbnailUrl is null in the step 3 response and fills in shortly after; fetch it later with Get a saved ad.
  • Uploading and creating boards don't consume ad credits.