Update parsing extractor (auto-creates new version)

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/parsing-extractors/{extractor_id}/"

payload = { "name": "Default parser (renamed)" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Default parser",
  "brief": "Agentic OCR parser with figure summarization.",
  "llm_model": "gpt-4o",
  "reducto_parsing_options": {
    "ocr_mode": "agentic",
    "figure_summarization": true
  },
  "use_fast_parsing_for_pdfs": false,
  "document_ids": [],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "extracted_parsed_documents_table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "extracted_blocks_table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "is_default": true,
      "reducto_parsing_options": {
        "ocr_mode": "agentic",
        "figure_summarization": true
      },
      "llm_model": "gpt-4o",
      "use_fast_parsing_for_pdfs": false
    }
  ],
  "default_version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_default": true,
    "reducto_parsing_options": {
      "ocr_mode": "agentic",
      "figure_summarization": true
    },
    "llm_model": "gpt-4o",
    "use_fast_parsing_for_pdfs": false
  },
  "latest_version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_default": true,
    "reducto_parsing_options": {
      "ocr_mode": "agentic",
      "figure_summarization": true
    },
    "llm_model": "gpt-4o",
    "use_fast_parsing_for_pdfs": false
  }
}

{
  "error": "User not found"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

PATCH

projects

{project_id}

parsing-extractors

{extractor_id}

import requests

url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/parsing-extractors/{extractor_id}/"

payload = { "name": "Default parser (renamed)" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Default parser",
  "brief": "Agentic OCR parser with figure summarization.",
  "llm_model": "gpt-4o",
  "reducto_parsing_options": {
    "ocr_mode": "agentic",
    "figure_summarization": true
  },
  "use_fast_parsing_for_pdfs": false,
  "document_ids": [],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "extracted_parsed_documents_table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "extracted_blocks_table": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "is_default": true,
      "reducto_parsing_options": {
        "ocr_mode": "agentic",
        "figure_summarization": true
      },
      "llm_model": "gpt-4o",
      "use_fast_parsing_for_pdfs": false
    }
  ],
  "default_version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_default": true,
    "reducto_parsing_options": {
      "ocr_mode": "agentic",
      "figure_summarization": true
    },
    "llm_model": "gpt-4o",
    "use_fast_parsing_for_pdfs": false
  },
  "latest_version": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_default": true,
    "reducto_parsing_options": {
      "ocr_mode": "agentic",
      "figure_summarization": true
    },
    "llm_model": "gpt-4o",
    "use_fast_parsing_for_pdfs": false
  }
}

{
  "error": "User not found"
}

{
  "error": "Authentication credentials were not provided."
}

{
  "error": "You do not have permission to perform this action."
}

{
  "error": "Not found."
}

Authorizations

Authorization

string

header

required

Use Authorization: Bearer

Path Parameters

project_id

string<uuid>

required

UUID of the project

extractor_id

string<uuid>

required

UUID of the extractor

Body

application/json

Converts source documents to text blocks via the parsing pipeline.

name

string

Example:

"Default parser"

brief

string

Example:

"Agentic OCR parser with figure summarization."

llm_model

string | null

Example:

"gpt-4o"

reducto_parsing_options

object

Example:

{
  "ocr_mode": "agentic",
  "figure_summarization": true
}

use_fast_parsing_for_pdfs

boolean

Example:

false

document_ids

string<uuid>[]

Example:

[]

import_mode

boolean

default:false

write-only

set_latest_as_default

boolean

write-only

Response

Updated

Converts source documents to text blocks via the parsing pipeline.

string<uuid>

read-only

name

string

Example:

"Default parser"

brief

string

Example:

"Agentic OCR parser with figure summarization."

llm_model

string | null

Example:

"gpt-4o"

reducto_parsing_options

object

Example:

{
  "ocr_mode": "agentic",
  "figure_summarization": true
}

use_fast_parsing_for_pdfs

boolean

Example:

false

document_ids

string<uuid>[]

Example:

[]

created_at

string<date-time>

read-only

updated_at

string<date-time>

read-only

extracted_parsed_documents_table

string<uuid> | null

read-only

extracted_blocks_table

string<uuid> | null

read-only

versions

object[]

read-only

Show child attributes

default_version

object | null

Immutable snapshot of a ParsingExtractor's version-bearing configuration.

Show child attributes

latest_version

object | null

Immutable snapshot of a ParsingExtractor's version-bearing configuration.

Show child attributes

Concepts

Endpoints

Update parsing extractor (auto-creates new version)

Authorizations

Path Parameters

Body

Response