---
title: "Replace knowledge-base processing settings"
method: PUT
path: "/api/v0/knowledge-bases/{kb_id}/processing-settings"
tags: ["Knowledge Bases"]
---

# Replace knowledge-base processing settings

`PUT /api/v0/knowledge-bases/{kb_id}/processing-settings`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/knowledge-bases/{kb_id}/processing-settings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/knowledge-bases/:kb_id/processing-settings/put.ts> (a function with typed inputs; its response is checked against the schema)

Replace the typed processing defaults applied to future document uploads into this collection. Running jobs keep the values already carried in their task contexts.

## Path parameters

- `kb_id` string, uuid, required

## Request body

- KnowledgeBaseProcessingSettingsRequest: Complete replacement for a collection's page-processing defaults.
  - `processing_preset` 'full' | 'text_and_tables' | 'layout_only' | 'existing_text' | 'disabled': Named template for page-processing options.
  - `page_processing_options` PageProcessingOptions: Stage selection for the per-page document pipeline.
    - `text_extraction` 'auto' | 'ocr' | 'vlm' | 'embedded' | 'none': How a page obtains text content.
    - `detect_layout` boolean
    - `extract_tables` boolean
    - `classify_pages` boolean
    - `classify_visuals` boolean
    - `transcribe_visuals` boolean
    - `describe_visuals` boolean
    - `generate_page_descriptions` boolean
    - `process_schematics` boolean
    - `aggregate_viewboxes` boolean
    - `defer_table_refinement` boolean
    - `defer_component_descriptions` boolean
    - `defer_page_descriptions` boolean

## Response `200`

Successful Response

- KnowledgeBaseProcessingSettingsResponse: Materialized processing defaults for a knowledge base.
  - `processing_preset` 'full' | 'text_and_tables' | 'layout_only' | 'existing_text' | 'disabled', required: Named template for page-processing options.
  - `page_processing_options` PageProcessingOptions, required: Stage selection for the per-page document pipeline.
    - `text_extraction` 'auto' | 'ocr' | 'vlm' | 'embedded' | 'none': How a page obtains text content.
    - `detect_layout` boolean
    - `extract_tables` boolean
    - `classify_pages` boolean
    - `classify_visuals` boolean
    - `transcribe_visuals` boolean
    - `describe_visuals` boolean
    - `generate_page_descriptions` boolean
    - `process_schematics` boolean
    - `aggregate_viewboxes` boolean
    - `defer_table_refinement` boolean
    - `defer_component_descriptions` boolean
    - `defer_page_descriptions` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-25** `fcd15f6d35b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/knowledge-bases/:kb_id/processing-settings/put.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)