Revoke TaskAgent Share

DELETE

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

DELETE

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

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

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": false,
11   "created": "2026-05-05T10:15:00Z",
12   "share_url": "https://app.rightbrain.ai/api/v1/public/task_agent_share/supportagent",
13   "title": "Support Agent",
14   "description": "Handles support triage and draft responses.",
15   "modified": "2026-05-05T10:15:00Z",
16   "tags": []
17 }

Revoke a TaskAgent share by setting active to false.

Requires task_agent:edit on the parent TaskAgent. The share record is preserved for management views and analytics.

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

share_idstringRequiredformat: "uuid"

TaskAgent share ID

Response

TaskAgent share revoked

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