Favorites

List favorite ad folders

Deprecated: favorites are now V3 boards; use /v1/boards. This endpoint is a compatibility facade over boards: folder ids are board ids (migrated V2 folder UUIDs are still accepted), saved favorite ids are board item ids, and favorites without a folder live in the scope's "Unsorted" board.

get/v1/favorites/ads/folders

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/favorites/ads/folders
  • Auth: HTTP bearer

Query parameters

scope'workspace' | 'personal' required

Favorites scope. Use personal only with a delegated_user credential. full_access credentials receive 403 for personal scope.

pageinteger
limitinteger
parentIdstring
Example:board_8b7c6d5e-4f3a-4b2c-9d1e-0f1a2b3c4d5e

Optional parent folder id (board id, or migrated V2 folder UUID). When provided, only direct children of that folder are returned.

rootOnlyboolean

When true, returns only root folders. Cannot be combined with parentId.

Response

Paginated favorite ad folders response. The response also includes the X-Request-Id header.

requestIdstring required

Request identifier mirrored in the X-Request-Id response header.

Example response

{
  "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
  "data": [
    {
      "id": "board_8b7c6d5e-4f3a-4b2c-9d1e-0f1a2b3c4d5e",
      "name": "Winning Creatives",
      "parentId": "board_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 130,
    "totalPages": 6
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.