Create TaskAgent Share

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/task_agent_id/share \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "title": "Support Agent",
>   "description": "Handles support triage and draft responses.",
>   "task_agent_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
>   "custom_short_id": "supportagent"
> }'

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

Create a public share link for a TaskAgent revision.

Requires task_agent:edit on the parent TaskAgent. If task_agent_revision_id is omitted, the active revision is shared. Custom short IDs must be unique and match the schema constraints; generated short IDs use high-entropy random characters.

TaskAgent shares cannot include Task-tool revisions backed by RAG collections, including disabled Task-tool attachments, because those collections are project-local and are not cloned. TaskAgent shares also cannot include deleted Task-tool dependencies.

Create a public share link for a TaskAgent revision. Requires `task_agent:edit` on the parent TaskAgent. If `task_agent_revision_id` is omitted, the active revision is shared. Custom short IDs must be unique and match the schema constraints; generated short IDs use high-entropy random characters. TaskAgent shares cannot include Task-tool revisions backed by RAG collections, including disabled Task-tool attachments, because those collections are project-local and are not cloned. TaskAgent shares also cannot include deleted Task-tool dependencies.

Authentication

Path parameters

Request

Response

Errors