For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardWebsiteCommunity
DocsAPI ReferenceChangelog
DocsAPI ReferenceChangelog
  • API Reference
      • GETList Project TaskAgent Shares
      • GETList TaskAgent Shares
      • POSTCreate TaskAgent Share
      • DELRevoke TaskAgent Share
      • POSTClone Shared TaskAgent
  • External Links
    • Agent API Docs
    • OpenAPI Spec
LogoLogo
DashboardWebsiteCommunity
API ReferenceTask Agent Shares

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/a/supportagent",
14    "title": "Support Agent",
15    "description": "Handles support triage and draft responses.",
16    "modified": "2026-05-05T10:15:00Z"
17  }
18]

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.

Was this page helpful?
Previous

Create TaskAgent Share

Next
Built with

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
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 null<=255 characters
descriptionstring or null<=1000 characters
expires_atstring or null
modifiedstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error