List Task Shares

GET

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

GET

/api/v1/org/:org_id/project/:project_id/task/:task_id/share

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

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

List all share links for a task.

Note: This endpoint returns a plain array of task shares, not a paginated response. All shares for the task are returned in a single request.

Returns all active and inactive shares created for the specified task, ordered by creation date (most recent first).

Each share includes:

Share URL and short ID
Title and description
View count and active status
Expiration date (if set)
Creation and modification timestamps

Use this endpoint to manage existing shares, check analytics, or deactivate old shares.

List all share links for a task. **Note**: This endpoint returns a plain array of task shares, not a paginated response. All shares for the task are returned in a single request. Returns all active and inactive shares created for the specified task, ordered by creation date (most recent first). Each share includes: - Share URL and short ID - Title and description - View count and active status - Expiration date (if set) - Creation and modification timestamps Use this endpoint to manage existing shares, check analytics, or deactivate old shares.

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.

Response

List of task shares

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