List TaskAgent Shares

GET

/org/:org_id/project/:project_id/task-agent/:task_agent_id/share

GET

/api/v1/org/:org_id/project/:project_id/task-agent/:task_agent_id/share

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

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

List share links for a single TaskAgent.

Requires task_agent:view on the parent TaskAgent. TaskAgentShare does not have an independent IAM surface in v1.

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 organization ID

project_idstringRequiredformat: "uuid"

The project ID

task_agent_idstringRequiredformat: "uuid"

The task agent ID

Response

List of TaskAgent shares

idstringformat: "uuid"

project_idstringformat: "uuid"

task_agent_idstringformat: "uuid"

task_agent_revision_idstringformat: "uuid"

user_idstringformat: "uuid"

task_agent_namestring

short_idstring

views_countinteger

activeboolean

createdstring

share_urlstringRead-only

titlestring or nullOptional<=255 characters

descriptionstring or nullOptional<=1000 characters

expires_atstring or nullOptional

modifiedstring or nullOptional

tagslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error