AdnovaDocs
Creative Hub

Start a multipart file upload

Initiate a multipart upload session. Use this in place of the single-PUT signed URL when the file is large (>~50 MB). Returns a fileId and an uploadId. Split the file into 10 MB (10485760-byte) parts; the last part holds the remainder. The per-file 1 GB cap and plan storage quota apply here too (rejected with 413). Step 1 of 5 in the multipart flow — see Multipart file upload for the full sequence.

POST
/files/multipart

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-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint).

Length1 <= length

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

curl -X POST "https://api.adnova.ai/creative-hub/v1/files/multipart" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \  -H "Content-Type: application/json" \  -d '{    "boardId": "01H8YC...",    "file": {      "name": "hero-video-4k.mp4",      "mime": "video/mp4",      "size": 184672000    }  }'
{
  "fileId": "01H8YA...",
  "uploadId": "VXBsb2FkSWQ-..."
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}