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
- Start the upload —
POST /saved-ads/uploadswith the targetboardIdand the file'sname,mime, and exactsizein bytes. Returns anuploadIdand a pre-signeduploadUrl. See Start an inspiration upload. - Upload the file —
PUTthe file's bytes directly touploadUrl(not through the Adnova API) with exactly these headers — the URL is signed for them, so any mismatch fails with an S3SignatureDoesNotMatcherror:Content-Type: <mime>— themimefrom step 1Content-Disposition: attachment; filename=<name>— thenamefrom step 1Content-Lengthequal to thesizefrom step 1
- Complete the upload —
POST /saved-ads/uploads/{uploadId}/completewith the sameboardId,name,mime, andsize, plus an optionaldescription. Adnova saves the inspiration in the board and returns it as a saved ad, with itsinspirationSavedAdId. 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 —
mimemust be animage/*orvideo/*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
boardIdthat doesn't exist or that you can't access returns403. - Complete only after the upload — calling step 3 before the file reaches
uploadUrlreturns400. - Complete once per upload — calling step 3 again saves a second copy.
- Thumbnails are generated in the background —
thumbnailUrlisnullin 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.
