List Project TaskAgent Shares

GET

/org/:org_id/project/:project_id/task_agent_share

GET

/api/v1/org/:org_id/project/:project_id/task_agent_share

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

1 {
2   "results": [
3     {
4       "id": "019a58ec-43b5-a1e5-60a8-c9653e6badbe",
5       "project_id": "0190a234-9876-5432-10ab-cdef01234567",
6       "task_agent_id": "019df849-e106-3301-5894-291b4c9c6cab",
7       "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
8       "user_id": "0190c234-1111-2222-3333-444444444444",
9       "task_agent_name": "Support Agent",
10       "short_id": "supportagent",
11       "views_count": 12,
12       "active": true,
13       "created": "2026-05-05T10:15:00Z",
14       "share_url": "https://app.rightbrain.ai/a/supportagent",
15       "title": "Support Agent",
16       "description": "Handles support triage and draft responses.",
17       "modified": "2026-05-05T10:15:00Z"
18     }
19   ],
20   "pagination": {
21     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
22     "has_next": true,
23     "page_limit": 25
24   }
25 }

List TaskAgent shares in a project.

TaskAgent shares are public share records scoped to the requested project. The endpoint does not expose share-specific IAM.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Query parameters

activebooleanOptional

Filter by active status

task_agent_idstringOptionalformat: "uuid"

Filter by specific TaskAgent ID

task_agent_namestringOptional

Filter by TaskAgent name (partial, case-insensitive)

cursorstringOptionalformat: "uuid"

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

page_limitintegerOptional1-100Defaults to 100

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

Response

Paginated list of TaskAgent shares

resultslist of objects

The list of items returned for the current page.

paginationobject or null

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