Favorites

Set favorite ad folder visibility

organization shares the board with the workspace; private is only allowed for folders created by the delegated user. 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.

patch/v1/favorites/ads/folders/{folderId}/visibility

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/{folderId}/visibility
Auth: HTTP bearer

Path parameters

folderIdstring required

Folder id: a board id, or the UUID of a V2 folder migrated to a board.

Example:board_8b7c6d5e-4f3a-4b2c-9d1e-0f1a2b3c4d5e

Query parameters

scope'workspace' | 'personal' required

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

Request body

visibility'private' | 'organization' required

organization publishes a root folder tree to the API credential workspace. private converts a root folder tree to delegated-user personal scope when the delegated user owns all contained folders and saved ads.

Response

Favorite ad folder visibility response. The response also includes the X-Request-Id header.

requestIdstring required

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"
  }
}

Changes

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