Publish Processor Version | Extend Documentation

from extend_ai import Extend
from extend_ai.processor_version import ProcessorVersionCreateRequestReleaseType
client = Extend(
    token="YOUR_TOKEN_HERE",
    extend_api_version="2025-04-21",
)
client.processor_version.create(
    id="processor_id_here",
    release_type=ProcessorVersionCreateRequestReleaseType.MAJOR,
)

{
  "success": true,
  "processorVersion": {
    "object": "document_processor_version",
    "id": "dpv_xK9mLPqRtN3vS8wF5hB2cQ",
    "processorId": "dp_Xj8mK2pL9nR4vT7qY5wZ",
    "processorType": "EXTRACT",
    "version": "draft",
    "config": {
      "type": "CLASSIFY",
      "baseProcessor": "classification_performance",
      "baseVersion": "3.2.0",
      "classifications": [
        {
          "id": "my_unique_id",
          "type": "invoice",
          "description": "An invoice is a document that lists the items purchased and the total amount due."
        }
      ],
      "classificationRules": "Remember, when it comes to differentiating between invoices and purchase orders, the most important thing to look for is the date of the document.",
      "advancedOptions": {
        "context": "default",
        "advancedMultimodalEnabled": false,
        "fixedPageLimit": 30,
        "pageRanges": [
          {
            "start": 1,
            "end": 10
          },
          {
            "start": 20,
            "end": 30
          }
        ]
      },
      "parser": {
        "target": "markdown",
        "chunkingStrategy": {
          "type": "page",
          "options": {
            "minCharacters": 100,
            "maxCharacters": 1000
          }
        },
        "engine": "parse_performance",
        "blockOptions": {
          "figures": {
            "enabled": true,
            "figureImageClippingEnabled": true
          },
          "tables": {
            "enabled": true,
            "targetFormat": "markdown",
            "tableHeaderContinuationEnabled": false,
            "cellBlocksEnabled": false,
            "agentic": {
              "enabled": false,
              "customInstructions": "string"
            }
          },
          "text": {
            "signatureDetectionEnabled": true,
            "agentic": {
              "enabled": false,
              "customInstructions": "string"
            }
          }
        },
        "advancedOptions": {
          "pageRotationEnabled": true,
          "agenticOcrEnabled": false,
          "pageRanges": [
            {
              "start": 1,
              "end": 10
            },
            {
              "start": 20,
              "end": 30
            }
          ],
          "excelParsingMode": "basic",
          "excelSkipHiddenContent": false,
          "excelUseRawCellValues": false,
          "excelSkipCalculation": true,
          "excelIncludeCellMetadata": false,
          "excelIncludeCellFormatting": false,
          "verticalGroupingThreshold": 1,
          "returnOcr": {
            "words": false,
            "lines": false
          },
          "alwaysConvertToPdf": false
        }
      }
    },
    "createdAt": "2024-03-21T15:30:00Z",
    "updatedAt": "2024-03-21T16:45:00Z",
    "processorName": "Invoice Processor",
    "description": "Updated extraction fields for new invoice format"
  }
}

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

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

Example: "dp_Xj8mK2pL9nR4vT7qY5wZ"

Request

This endpoint expects an object.

releaseTypeenumRequired

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

Allowed values:

descriptionstringOptional

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

configobjectOptional

The configuration for this version of the processor. The type of configuration must match the processor type.

Response

Successfully published processor version

successboolean

processorVersionobject

Errors

400

Bad Request Error

401

Unauthorized Error

Authentication

Path parameters

Headers

Request

Response

Errors