Create Task Forwarder | Rightbrain Docs | Transform AI Ideas into Production Tasks

1	import requests
2
3	url = "https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task_forwarder"
4
5	payload = {
6	"name": "Task Results Email",
7	"forwarder_type": "email",
8	"config": {
9	"recipient_emails": ["[email protected]"],
10	"subject_template": "Task completed: {task_name}",
11	"body_template": "Results: {output}"
12	}
13	}
14	headers = {
15	"Authorization": "Bearer <token>",
16	"Content-Type": "application/json"
17	}
18
19	response = requests.post(url, json=payload, headers=headers)
20
21	print(response.json())

{
  "id": "string",
  "project_id": "string",
  "created": "string",
  "modified": "string",
  "name": "string",
  "description": "string",
  "forwarder_type": "webhook",
  "config": {
    "destination_url": "string"
  },
  "config_sensitive": {
    "signing_key": "string"
  }
}

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

Authentication

Path parameters

Request

Response

Errors