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."
}Parsing Extractors
Update parsing extractor (auto-creates new version)
Partial update. Version-bearing fields: reducto_parsing_options,
llm_model, use_fast_parsing_for_pdfs.
Pass set_latest_as_default: true to promote the new version.
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
BearerAuthTokenAuth
Use Authorization: Bearer <token>. The token is either a user token / OAuth access
token, or a service-account API key (cfk_...). A key is valid on every endpoint and
acts as its service account, an organization member with per-store permissions.
Refused keys answer 403 with Invalid API key., API key revoked.,
API key expired. or API key disabled..
Path Parameters
UUID of the project
UUID of the extractor
Body
application/json
Converts source documents to text blocks via the parsing pipeline.
Example:
"Default parser"
Example:
"Agentic OCR parser with figure summarization."
Example:
"gpt-4o"
Example:
{
"ocr_mode": "agentic",
"figure_summarization": true
}
Example:
false
Example:
[]
Response
Updated
Converts source documents to text blocks via the parsing pipeline.
Example:
"Default parser"
Example:
"Agentic OCR parser with figure summarization."
Example:
"gpt-4o"
Example:
{
"ocr_mode": "agentic",
"figure_summarization": true
}
Example:
false
Example:
[]
Show child attributes
Show child attributes
Immutable snapshot of a ParsingExtractor's version-bearing configuration.
Show child attributes
Show child attributes
Immutable snapshot of a ParsingExtractor's version-bearing configuration.
Show child attributes
Show child attributes