Publish Processor Version

Publish a new version of an existing processor in Extend.

Publish Processor Version

cURL

curl --request POST \
  --url https://api-prod.extend.app/v1/processors/:id/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "releaseType": "<string>",
  "description": "<string>",
  "config": {
    "type": "<string>",
    "baseProcessor": "<string>",
    "baseVersion": "<string>",
    "schema": {},
    "fields": [
      {
        "id": "<string>",
        "name": "<string>",
        "type": "<string>",
        "description": "<string>",
        "schema": [
          {}
        ],
        "enum": [
          {
            "value": "<string>",
            "description": "<string>"
          }
        ]
      }
    ],
    "extractionRules": "<string>",
    "advancedOptions": {
      "fixedPageLimit": 123,
      "splitMethod": "<string>",
      "splitIdentifierRules": "<string>",
      "splitExcelDocumentsBySheetEnabled": true
    },
    "classifications": [
      {
        "id": "<string>",
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "classificationRules": "<string>",
    "splitClassifications": [
      {
        "id": "<string>",
        "type": "<string>",
        "description": "<string>"
      }
    ],
    "splitRules": "<string>"
  }
}
'

Example Success Response

{
  "success": true,
  "processorVersion": {
    "object": "document_processor_version",
    "id": "processor_version_5678",
    "processorId": "processor_1234",
    "processorType": "EXTRACT",
    "description": "Updated extraction rules for invoice processing",
    "version": "1.2.0",
    "config": {
      "fields": [
        {
          "id": "invoice_number",
          "name": "invoice_number",
          "description": "The invoice number",
          "type": "string",
        },
        {
          "id": "invoice_date",
          "name": "invoice_date",
          "description": "The date of the invoice",
          "type": "date",
        }
      ]
    },
    "createdAt": "2024-03-01T14:00:00Z",
    "updatedAt": "2024-03-01T14:00:00Z"
  }
}

This endpoint allows you to publish a new version of an existing processor. Publishing a new version creates a snapshot of the processor’s current configuration and makes it available for use in workflows. Publishing a new version does not automatically update existing workflows using this processor. You may need to manually update workflows to use the new version if desired.

Path Parameters

id · string · required

The ID of the processor to publish a new version for.

Body

releaseType · string · required

The type of release for this version. The two options are: “major” and “minor”, which will increment the version number accordingly.

description · string

A description of the changes in this version. This helps track the evolution of the processor over time.

config · object

Optionally supply a config to be used in this published version. If not supplied, the config for your existing draft version will be used.

Extraction

Show properties

type · string · required

Must be "EXTRACT" for extraction processors.

baseProcessor · string

The base processor to use. For extractors, this is either "extraction_performance" or "extraction_light". See the base processor documentation for more details.

baseVersion · string

The version of the base processor to use (e.g. "4.0.0"). If this is provided, baseProcessor must be provided as well. See the processor changelog for available versions.

schema · object

The schema that defines the structure of data to extract from documents. One of schema or fields must be provided. We recommend using schema as fields is deprecated. See the extraction processor schema documentation for more details.

fields · array · deprecated

The schema that defines the structure of data to extract from documents. One of schema or fields must be provided. We recommend using schema as fields is deprecated. See the extraction processor schema documentation for more details on using the fields shape.

Show properties

id · string · required

Unique identifier for the field.

name · string · required

Human-readable name for the field.

type · string · required

Type of the field. Supported values:

• string: Text values
• number: Numeric values
• currency: Monetary values
• boolean: True/false values
• date: Date values
• array: Lists of values (requires schema)
• enum: Values from a predefined list (requires enum)
• object: Nested structure (requires schema)
• signature: Signature information

description · string · required

Detailed description of the field, including expected content and format.

schema · array

Required when type is “array” or “object”. Contains nested field definitions.

enum · array

Required when type is “enum”. List of allowed values.

Show properties

value · string · required

The enum value.

description · string · required

Description of the enum value.

extractionRules · string

Custom rules to guide the extraction process in natural language.

advancedOptions · object

Advanced configuration options.

Show properties

fixedPageLimit · number

Limit processing to a specific number of pages from the beginning of the document.

documentKind · string

Provide a hint about the document type (e.g. “invoice”, “receipt”, etc.).

keyDefinitions · string

Define specific key terms or concepts relevant to the document type.

modelReasoningInsightsEnabled · boolean

Enable model reasoning insights in the extraction results.

advancedMultimodalEnabled · boolean

Enable advanced multimodal processing for better handling of visual elements.

citationsEnabled · boolean

Enable citation information for extracted fields.

advancedFigureParsingEnabled · boolean

Enable advanced parsing of figures and diagrams in the document.

chunkingOptions · object

Options for controlling document chunking.

Show properties

chunkingStrategy · string

Strategy for chunking the document. Supported values:

• standard: Default chunking strategy
• semantic: Content-aware chunking based on document structure

customSemanticChunkingRules · string

Custom rules for semantic chunking in natural language.

pageChunkSize · number

Number of pages per chunk.

chunkSelectionStrategy · string

Strategy for selecting chunks. Supported values:

• intelligent: AI-based selection
• confidence: Select based on confidence score
• take_first: Always use first chunk
• take_last: Always use last chunk

Classification

Show properties

type · string · required

Must be "CLASSIFY" for classification processors.

baseProcessor · string

The base processor to use. For classifiers, must be "classification_performance" or "classification_light". See the base processor documentation for more details.

baseVersion · string

The version of the base processor to use (e.g. "3.2.0"). If this is provided, baseProcessor must be provided as well. See the processor changelog for available versions.

classifications · array · required

Array of possible classifications for the document.

Show properties

id · string · required

Unique identifier for the classification. We recommend lowercase, underscore-separated format.

type · string · required

Type identifier for the classification.

description · string · required

Detailed description of the classification.

classificationRules · string

Custom rules to guide the classification process in natural language.

advancedOptions · object

Advanced configuration options.

Show properties

fixedPageLimit · number

Limit processing to a specific number of pages from the beginning of the document.

context · string

The context to use for classification. Supported values: default max

advancedMultimodalEnabled · boolean

Enable advanced multimodal processing for better handling of visual elements during classification.

Splitter

Show properties

type · string · required

Must be "SPLITTER" for splitter processors.

baseProcessor · string

The base processor to use. For splitters, this can currently only be "splitter_performance". See the base processor documentation for more details.

baseVersion · string

The version of the base processor to use (e.g. "1.0.0"). If this is provided, baseProcessor must be provided as well. See the processor changelog for available versions.

splitClassifications · array · required

Array of classifications that define the possible types of document sections.

Show properties

id · string · required

Unique identifier for the split classification.

type · string · required

Type identifier for the split classification.

description · string · required

Detailed description of the document section type.

splitRules · string

Custom rules to guide the document splitting process in natural language.

advancedOptions · object

Advanced configuration options.

Show properties

fixedPageLimit · number

Limit processing to a specific number of pages from the beginning of the document.

splitMethod · string

Method to use for splitting. Supported values:

• high_precision: More accurate but potentially slower
• low_latency: Faster but potentially less precise

splitIdentifierRules · string

splitExcelDocumentsBySheetEnabled · boolean

For Excel documents, split by worksheet.

Response

success · boolean

A true or false value indicating whether the processor version was published successfully or not.

processorVersion · ProcessorVersion

A ProcessorVersion object representing the newly published version of the processor. See the ProcessorVersion object for more details.

Error Responses

success · boolean

Will be false if the request failed.

error · string

A description of the error that occurred.

Common Errors

• 400 Bad Request: If the request body fails schema validation or if there’s an issue with the provided configuration, particularly when it comes to the config which depends on the processor type.

Example Success Response

{
  "success": true,
  "processorVersion": {
    "object": "document_processor_version",
    "id": "processor_version_5678",
    "processorId": "processor_1234",
    "processorType": "EXTRACT",
    "description": "Updated extraction rules for invoice processing",
    "version": "1.2.0",
    "config": {
      "fields": [
        {
          "id": "invoice_number",
          "name": "invoice_number",
          "description": "The invoice number",
          "type": "string",
        },
        {
          "id": "invoice_date",
          "name": "invoice_date",
          "description": "The date of the invoice",
          "type": "date",
        }
      ]
    },
    "createdAt": "2024-03-01T14:00:00Z",
    "updatedAt": "2024-03-01T14:00:00Z"
  }
}