List the current user's favourites in the active organization
GET
/v1/account/favoritesRequires resources:read. Personal bookmarks never grant resource access. Titles are last-saved labels; opening a destination must still use its authorized resource API. Newest first, with a stable keyset cursor. Uses X-Computer-Agents-Organization or the caller's personal organization.
How to call this endpoint
Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.
Path, query, and header parameters
These parameters control which ACP object the endpoint acts on and how the request is processed.
Path parameters
None.
Query parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | No | — |
| cursor | query | string | No | — |
Header parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| X-Computer-Agents-Organization | header | string | No | — |
Body schema
This endpoint does not require a request body.
None.
What the API returns
Each response code below includes the documented payload shape for the ACP API.
200Personal favourites pageapplication/json
| Field | Type | Required | Description |
|---|---|---|---|
| data | object[] | Yes | — |
| data[].resourceType | string | Yes | — |
| data[].resourceId | string | Yes | — |
| data[].title | string | Yes | Display title. |
| data[].navigation | object | Yes | Allowlisted platform navigation fields only, each a nonempty string of at most 512 characters; total JSON at most 4096 characters. URLs, credentials, arbitrary keys, package-origin access context and resource content are rejected. See the Favourites contract for the navigation field inventory. |
| data[].navigation.page | thread | tasks | calendar | metronome | resources | tools | files | team | organization | knowledge | packages | channels | guardrails | evaluations | tests | assurance | fine-tuning | quality | inference | models | resource-templates | develop-webhooks | develop-api-keys | develop-security | develop-evidence-agents | batches | Yes | — |
| data[].createdAt | string | Yes | ISO 8601 timestamp. |
| data[].updatedAt | string | Yes | ISO 8601 timestamp. |
| nextCursor | string | Yes | — |
400Invalid pagination or missing principal identity
None.
401Authentication required
None.
403Insufficient scope or inactive organization membership
None.
500Favourites storage failed
None.
List the current user's favourites in the active organization
Loading...
Response 200
Loading...