AdnovaDocs
Creative Hub

Bulk link files to a board

Link up to 50 files into one more board in a single call — the bulk form of Link a file to a board. Files stay in their current boards. Each file is processed on its own, so one bad id does not fail the others: the response lists the files that were linked and, under failed, why each of the rest was not. The board itself must exist in the header workspace, or the whole call returns 404.

POST
/files/bulk/link

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/bulk/link" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \  -H "Content-Type: application/json" \  -d '{    "fileIds": [      "01J8ZF9K8M7N6P5R4S3T2V1W0X",      "01J8ZG0L9N8P7Q6R5S4T3V2W1Y"    ],    "boardId": "01J8ZB1C2D3E4F5G6H7J8K9M0N"  }'
{
  "boardId": "01J8ZB1C2D3E4F5G6H7J8K9M0N",
  "linked": [
    "01J8ZF9K8M7N6P5R4S3T2V1W0X"
  ],
  "failed": [
    {
      "fileId": "01J8ZG0L9N8P7Q6R5S4T3V2W1Y",
      "error": "File not found!"
    }
  ]
}
{
  "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"
}