List Tags

GET

/org/:org_id/project/:project_id/:entity_type/tag

GET

/api/v1/org/:org_id/project/:project_id/:entity_type/tag

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task/tag \
>      -H "Authorization: Bearer <token>"

1 {
2   "results": [
3     {
4       "name": "production",
5       "entity_type": "task",
6       "id": "019f8a03-4d43-7001-8e4d-5d8f20713031",
7       "created_at": "2026-06-15T09:12:00Z",
8       "is_project_tag": false,
9       "is_global_tag": false,
10       "description": "Tasks and revisions running in the live production environment",
11       "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
12       "children": [],
13       "tagged_entities": [
14         "019f8a06-6000-7002-8b1a-6e9031824052",
15         "019f8a06-6000-7003-8b1a-6e9031824053"
16       ]
17     },
18     {
19       "name": "billing",
20       "entity_type": "task",
21       "id": "019f8a03-4d43-7002-8e4d-5d8f20713032",
22       "created_at": "2026-06-20T14:05:00Z",
23       "is_project_tag": false,
24       "is_global_tag": false,
25       "description": "Tasks related to invoicing and billing workflows",
26       "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
27       "children": [],
28       "tagged_entities": [
29         "019f8a06-6000-7004-8b1a-6e9031824054"
30       ]
31     }
32   ],
33   "pagination": {
34     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
35     "has_next": true,
36     "page_limit": 25
37   }
38 }

List all tags in the project for the requested entity type.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

entity_typeenumRequired

The type of entity this tag applies to (task, task_revision, task_share, skill, task_agent_revision, or task_agent_share).

Query parameters

page_limitinteger or nullOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstring or nullOptionalformat: "uuid"

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Response

Tags retrieved

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error