Update Task Forwarder

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task_forwarder/task_forwarder_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "config": {
>     "destination_url": "https://crm.internal.acme-logistics.com/webhooks/rightbrain/v2"
>   },
>   "forwarder_type": "webhook"
> }'

1 {
2   "config": {
3     "destination_url": "https://crm.internal.acme-logistics.com/webhooks/rightbrain/v2"
4   },
5   "config_sensitive": {
6     "signing_key": "whsec_9f2c9d9b7a4e4b6c8f0a1b2c3d4e5f60"
7   },
8   "created": "2026-06-15T08:20:00Z",
9   "description": "Forwards completed order-classification results to the CRM webhook.",
10   "forwarder_type": "webhook",
11   "id": "0197d3e5-5e7f-7d24-b160-7c8d9e0f1a2b",
12   "modified": "2026-07-20T09:30:00Z",
13   "name": "CRM Order Sync",
14   "project_id": "0190a234-9876-5432-10ab-cdef01234567"
15 }

Update task forwarder configuration.

Modifiable fields:

Name and description
Type-specific configuration (config, config_sensitive)

Note: forwarder_type must match the forwarder’s existing type.

Update task forwarder configuration. Modifiable fields: - Name and description - Type-specific configuration (`config`, `config_sensitive`) Note: `forwarder_type` must match the forwarder's existing type.

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

task_forwarder_idstringRequiredformat: "uuid"

The specific Task to reference.

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

WebhookForwarderUpdateobjectRequired

EmailForwarderUpdateobjectRequired

Response

Task forwarder updated

WebhookForwarderInDBobject

EmailForwarderInDBobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error