AdnovaDocs
Creative Hub

List boards

Returns every board in the workspace as a flat array in tree order (top-level boards and subboards mixed); rebuild the tree from parent / path if you need a hierarchy. Pass ?parent= to list only one board's direct children (root for the top-level boards), and ?q= to filter by board name (case-insensitive substring). The two filters combine.

GET
/boards

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

Query Parameters

q?string

Case-insensitive substring match against the board name.

parent?string

List only the direct children of this board id. Pass root for the top-level boards. An unknown board id returns 404.

Length1 <= length

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/creative-hub/v1/boards?q=spring&parent=root" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P"
{
  "data": [
    {
      "_id": "01H8YC...",
      "name": "Spring Collection",
      "parent": null,
      "path": [],
      "description": "All creatives for the Spring 2026 collection.",
      "tags": [],
      "createdAt": "2019-08-24T14:15:22Z",
      "modifiedAt": "2019-08-24T14:15:22Z",
      "position": 0
    }
  ]
}
{
  "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"
}