List Task Forwarders

GET

/org/:org_id/project/:project_id/task_forwarder

GET

/api/v1/org/:org_id/project/:project_id/task_forwarder

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

1 {
2   "results": [
3     {
4       "config": {
5         "destination_url": "https://hooks.slack.com/services/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"
6       },
7       "created": "2026-06-20T16:45:00Z",
8       "description": "Posts a Slack notification whenever a support-ticket task run completes.",
9       "forwarder_type": "webhook",
10       "id": "0197e4f6-6f80-7e35-8271-8d9e0f1a2b3c",
11       "modified": "2026-06-20T16:45:00Z",
12       "name": "Support Team Slack Alert",
13       "project_id": "0190a234-9876-5432-10ab-cdef01234567"
14     },
15     {
16       "config": {
17         "body_template": "The task {task_name} finished with status {status}.",
18         "recipient_emails": [
19           "[email protected]"
20         ],
21         "subject_template": "Task completed: {task_name}"
22       },
23       "created": "2026-07-05T12:00:00Z",
24       "description": "Emails task run results to the operations team.",
25       "forwarder_type": "email",
26       "id": "0198f607-7091-7f46-9382-9e0f1a2b3c4d",
27       "modified": "2026-07-05T12:00:00Z",
28       "name": "Weekly Report Email",
29       "project_id": "0190a234-9876-5432-10ab-cdef01234567"
30     }
31   ],
32   "pagination": {
33     "next_cursor": "0190a234-8dc6-6d08-aea9-928fcecad8f2",
34     "has_next": true,
35     "page_limit": 25
36   }
37 }

List all task forwarders for the project.

Returns configured forwarders with their type-specific configuration.

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.

Query parameters

page_limitintegerOptional1-100Defaults to 100

The maximum number of items to return per page. Defaults to 100 if not specified.

cursorstring or nullOptionalformat: "uuid"

A cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.

Response

Task forwarders retrieved

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error