Create Task Forwarder

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task_forwarder \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Task Results Email",
>   "forwarder_type": "email",
>   "config": {
>     "recipient_emails": [
>       "[email protected]"
>     ],
>     "subject_template": "Task completed: {task_name}",
>     "body_template": "Results: {output}"
>   }
> }'

1 {
2   "id": "string",
3   "project_id": "string",
4   "created": "string",
5   "modified": "string",
6   "name": "string",
7   "description": "string",
8   "forwarder_type": "webhook",
9   "config": {
10     "destination_url": "string"
11   },
12   "config_sensitive": {
13     "signing_key": "string"
14   }
15 }

Create a new task forwarder to automatically route task outputs.

Task forwarders enable:

Webhook notifications when tasks complete
Email notifications with customizable templates
Custom integrations with external systems

Configuration varies by forwarder type:

webhook: HTTP POST to external endpoints with optional HMAC signing
email: Send task results via email with customizable subject and body templates

Use GET /task_forwarder_type to retrieve the complete configuration schema for each type.

Create a new task forwarder to automatically route task outputs. Task forwarders enable: - Webhook notifications when tasks complete - Email notifications with customizable templates - Custom integrations with external systems Configuration varies by forwarder type: - **webhook**: HTTP POST to external endpoints with optional HMAC signing - **email**: Send task results via email with customizable subject and body templates Use `GET /task_forwarder_type` to retrieve the complete configuration schema for each type.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

WebhookForwarderCreateobjectRequired

EmailForwarderCreateobjectRequired

Response

Successful Response

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