AdnovaDocs
Creative Hub

Search files

Search files (and matching boards) across the workspace by name or tags. All body fields are optional — an empty body returns the most recent items. boardIds scopes the search to those boards and everything nested inside them. Use filter to narrow file hits by custom-field values, tags, extensions or creation date. Results come back split into file hits and board hits, each paginated independently via the limit / skip query parameters.

POST
/files/search

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

limit?integer
Range1 <= value <= 250
skip?integer
Range0 <= value

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

curl -X POST "https://api.adnova.ai/creative-hub/v1/files/search" \  -H "x-workspace-id: 01J8ZQ9X2K3M4N5P6R7S8T9V0W" \  -H "x-org-id: 01J8ZQ7B3C4D5F6G7H8K9M0N1P" \  -H "Content-Type: application/json" \  -d '{}'
{
  "files": {
    "results": [
      {}
    ],
    "totalRecords": 42,
    "paginationUsed": {}
  },
  "folders": {
    "results": [
      {}
    ],
    "totalRecords": 42,
    "paginationUsed": {}
  }
}
{
  "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"
}