List Task Forwarder Types | Rightbrain Docs | Transform AI Ideas into Production Tasks

curl https://app.rightbrain.ai/api/v1/org/123e4567-e89b-12d3-a456-426614174000/project/123e4567-e89b-12d3-a456-426614174001/task_forwarder_type \
     -H "Authorization: Bearer <token>"

[
  {
    "type": "webhook",
    "name": "Webhook",
    "description": "Forward task results via HTTP POST to a webhook URL",
    "config_schema": {
      "type": "object",
      "properties": {
        "destination_url": {
          "type": "string",
          "description": "The URL where Task Run result will be forwarded"
        }
      },
      "required": [
        "destination_url"
      ]
    },
    "config_sensitive_schema": {
      "type": "object",
      "properties": {
        "signing_key": {
          "type": "string",
          "description": "A secret key used to sign the forwarded data"
        }
      }
    }
  },
  {
    "type": "email",
    "name": "Email",
    "description": "Send task results via email with customizable templates",
    "config_schema": {
      "type": "object",
      "properties": {
        "recipient_emails": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "email"
          },
          "description": "List of email addresses"
        },
        "subject_template": {
          "type": "string",
          "description": "Email subject with {variable} placeholders"
        },
        "body_template": {
          "type": "string",
          "description": "Email body with {variable} placeholders"
        }
      },
      "required": [
        "recipient_emails",
        "subject_template",
        "body_template"
      ]
    }
  }
]

List all available task forwarder types with their configuration schemas.

Note: This endpoint returns a plain array of forwarder types, not a paginated response. All available types are returned in a single request.

Returns metadata for each forwarder type to help frontends build dynamic configuration UIs:

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

Each type includes:

JSON Schema for required configuration fields
JSON Schema for sensitive configuration (if applicable)
Field descriptions and validation rules

Use this endpoint to dynamically render appropriate form fields based on the selected forwarder type.

List all available task forwarder types with their configuration schemas. **Note**: This endpoint returns a plain array of forwarder types, not a paginated response. All available types are returned in a single request. Returns metadata for each forwarder type to help frontends build dynamic configuration UIs: - **webhook**: HTTP POST to external endpoints with optional HMAC signing - **email**: Send task results via email with customizable templates Each type includes: - JSON Schema for required configuration fields - JSON Schema for sensitive configuration (if applicable) - Field descriptions and validation rules Use this endpoint to dynamically render appropriate form fields based on the selected forwarder 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.

Response

Available forwarder types with configuration schemas

typestring

The forwarder type identifier (e.g., ‘webhook’, ‘email’)

namestring

Human-readable name for the forwarder type

descriptionstring

Description of what this forwarder type does

config_schemamap from strings to any

JSON Schema for the forwarder's configuration

config_sensitive_schemamap from strings to any or null

JSON Schema for the forwarder’s sensitive configuration (if any). Will be encrypted within the application.

Authentication

Path parameters

Response

Errors