List Input Processors

GET

/org/:org_id/project/:project_id/input_processor

GET

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

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

[
  {
    "name": "url_fetcher",
    "description": "Fetches the HTML content for the provided site and replaces the URL with the fetched content.",
    "config_schema": {
      "additionalProperties": true,
      "properties": {
        "fallback_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Text to return if hosted fetching fails.",
          "title": "Fallback Text"
        },
        "fetch_mode": {
          "default": "default",
          "description": "How the URL should be fetched. Use 'default' for the standard fetch behavior or 'direct' to fetch the URL directly.",
          "enum": [
            "default",
            "direct"
          ],
          "title": "Fetch Mode",
          "type": "string"
        }
      },
      "title": "ConfigSchema",
      "type": "object"
    }
  },
  {
    "name": "document_content_extractor",
    "description": "Extracts the content from a document and replaces the variable with the extracted content."
  },
  {
    "name": "audio_transcriber",
    "description": "Transcribes audio files to text using Google Gemini. Supports WAV, MP3, AIFF, AAC, OGG, and FLAC formats. The transcribed text replaces the audio file in the task input.",
    "config_schema": {
      "additionalProperties": false,
      "description": "Configuration for audio transcription.",
      "properties": {
        "audio_timestamp": {
          "default": false,
          "description": "Include timestamps in the transcription output.",
          "title": "Audio Timestamp",
          "type": "boolean"
        },
        "language": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Language hint (e.g., 'en', 'es'). Auto-detected if None.",
          "title": "Language"
        },
        "prompt": {
          "default": "Transcribe this audio.",
          "description": "Instruction for the transcription model. Can request summaries, diarisation, structured output, etc.",
          "title": "Prompt",
          "type": "string"
        }
      },
      "title": "ConfigSchema",
      "type": "object"
    }
  },
  {
    "name": "perplexity_search",
    "description": "Searches Perplexity for the provided query and returns ranked web results with optional snippets, dates, and metadata.",
    "config_schema": {
      "additionalProperties": false,
      "description": "Configuration schema for Perplexity search",
      "properties": {
        "country": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Country to target search results origin.",
          "examples": [
            "GB",
            "US"
          ],
          "title": "Country"
        },
        "fallback_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Text to return on error instead of raising exception",
          "title": "Fallback Text"
        },
        "max_results": {
          "default": 5,
          "description": "Number of search results to return",
          "maximum": 100,
          "minimum": 1,
          "title": "Max Results",
          "type": "integer"
        },
        "query_context": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Template string with single variable placeholder (e.g., '{company}', '{topic}') that will be replaced with user input",
          "title": "Query Context"
        }
      },
      "title": "ConfigSchema",
      "type": "object"
    }
  }
]

Returns a list of all available input processors that can be used to transform task inputs.

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

Input processors are utility functions that can modify or enhance the input data before it is processed by the task. Each processor supports optional configuration parameters to customize its behavior; config_schema is null for processors that take no configuration.

Available processors:

url_fetcher: Fetches HTML content from URLs
document_content_extractor: Extracts text from uploaded documents
audio_transcriber: Transcribes audio files to text
perplexity_search: Searches the web for real-time information

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.

Response

Successfully retrieved list of available input processors with their configuration options

namestring

The unique identifier/name of the input processor. Used to reference this processor in API calls.

descriptionstring

A human-readable description of what the input processor does.

config_schemamap from strings to any or nullOptional

JSON Schema describing the available configuration options for this processor. Null if the processor does not have a configuration schema.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error