Creative Hub
Creative Hub overview
Organise creative assets in workspace boards; upload images and video.
The Creative Hub API manages your creative assets — organise files into boards and upload images or video via a signed-URL handshake. Assets uploaded here are referenced by fileId in Ad Launcher launch payloads.
What you can do
- Manage boards — create, list, fetch, rename, move, reorder, and delete workspace-scoped containers for your creative files. Boards can be nested (subboards) via the
parentfield, moved or deleted individually or in bulk. - List and search files — paginated listing within a board (filterable by extension, name, or date range), or search across the whole workspace by name or tags, filtered by custom-field values, tags, extensions, or creation date.
- Upload files via single-PUT for small files, or multipart for large videos.
- Manage files — fetch, rename, move, link into other boards, download, preview, merge, and delete files — individually or in bulk.
- Manage versions — every file keeps a version history. List versions, upload a new version, switch the active one, rename, delete, or split a version into its own file.
- Tag files — list or create workspace tags, then assign them per file or in bulk.
- Comment on files — threaded review comments on a specific file version, anchored to a video timestamp or an on-screen annotation. List, create, resolve, and delete threads, and manage their replies.
Typical flow
- Create a board. Create a board or List boards to pick an existing one.
- Upload a file. Upload a file with the
boardId, thenPUTthe bytes to the returneduploadUrl. - Complete the upload. Complete creative upload — the response carries the
fileIdandversionId. - Browse board contents. List files in a board returns a board's direct children, filterable by extension, name, or date.
For large videos (>~50 MB), use the multipart flow instead of the single-PUT upload.
Once you have a fileId, pass it into an Ad Launcher launch payload.
Auth & request context
Every request needs three headers — the API key plus workspace and org context:
api-key: YOUR_KEY_HERE
x-workspace-id: YOUR_WORKSPACE_ID
x-org-id: YOUR_ORG_IDapi-key— required on every request. Create one from the Adnova dashboard.x-workspace-id— required on every Creative Hub endpoint.x-org-id— required on every Creative Hub endpoint.
The same API key works across Creative Hub, Ad Launcher, Manage, and Analytics.
