Favorites

Reorder favorite email folders

Boards have no manual order: the folders are validated and echoed back in the requested order, but no order is persisted. 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/emails/folders/reorder

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/emails/folders/reorder
  • 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.

Request body

Example request

{
  "folders": [
    {
      "id": "0e91fbef-3d02-44d8-b024-3bda62fb050c",
      "order": 1
    }
  ]
}

Response

Favorite email folders reorder response.

requestIdstring required

Example response

{
  "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
  "data": {
    "reordered": true,
    "scope": "workspace",
    "folders": [
      {
        "id": "board_0e91fbef-3d02-44d8-b024-3bda62fb050c",
        "name": "Lifecycle Emails",
        "parentId": "board_4b84a8f9-44df-4a18-9f08-66e6db6403da"
      }
    ]
  }
}

Changes

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