Revoke Task Share

DELETE

/org/:org_id/project/:project_id/task/:task_id/share/:share_id

Revoke a task share by deactivating it.

This endpoint sets the share’s active status to false, preventing further cloning. The share link will no longer work for cloning, but the record is preserved for analytics.

Revoking a share:

Sets active = false
Prevents cloning through the share link
Preserves share record and view count
Cannot be undone (create a new share instead)

Requires edit permission on the task.

Revoke a task share by deactivating it. This endpoint sets the share's active status to false, preventing further cloning. The share link will no longer work for cloning, but the record is preserved for analytics. Revoking a share: - Sets active = false - Prevents cloning through the share link - Preserves share record and view count - Cannot be undone (create a new share instead) Requires edit permission on the task.

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 unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

task_idstringRequiredformat: "uuid"

The specific Task to reference.

share_idstringRequiredformat: "uuid"

The ID of the task share to revoke

Response

Share successfully revoked

idstringformat: "uuid"

task_idstringformat: "uuid"

task_revision_idstringformat: "uuid"

user_idstringformat: "uuid"

task_namestring

Name of the associated task

short_idstring

share_urlstring

views_countinteger

activeboolean

createdstring

modifiedstring

titlestring or nullOptional

descriptionstring or nullOptional

expires_atstring or nullOptional

task_run_idstring or nullOptionalformat: "uuid"

Optional TaskRun ID included as an example of the task's performance.

tagslist of objectsOptionalDefaults to []

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

1	{
2	"id": "019a58ec-43b5-a1e5-60a8-c9653e6badbe",
3	"task_id": "0190a234-8dc6-6d08-aea9-928fcecad8f1",
4	"task_revision_id": "019929cf-f316-196f-3bf9-118b22da0c3c",
5	"user_id": "0190c234-1111-2222-3333-444444444444",
6	"task_name": "Awesome synonymiser",
7	"short_id": "tsiJP",
8	"share_url": "https://app.rightbrain.ai/s/tsiJP",
9	"views_count": 15,
10	"active": false,
11	"created": "2025-11-06T11:27:50.140234Z",
12	"modified": "2025-11-06T11:27:50.140234Z",
13	"tags": []
14	}

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