---
title: "Save Config"
method: POST
path: "/api/configs/"
tags: ["configs"]
---

# Save Config

`POST /api/configs/`

Save a new configuration.

## Request body

- ConfigUpdateData — Configuration update - only changed parameters need to be provided with proper validation
  - `QueryLLM` QueryLLMConfig
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `MODEL_NAME` string — The name of the non-reasoning model to be used.
    - `SYSTEM_INSTRUCTION` string — The system instruction string.
    - `MAX_CHAR_SIZE_TO_ANSWER` integer — Maximum character size to answer.
    - `TEMPERATURE` number — Temperature value for randomness.
    - `MAX_TOKENS` integer — Maximum number of tokens allowed.
  - `Agents` AgentsConfig
    - `ENABLED` boolean — Whether to use agents mode for queries.
    - `AGENT_MODEL_NAME` string — The name of the model to be used for the agent.
    - `AGENT_PROMPT` string
    - `LLM_PAGE_FILTER_MODEL_NAME` string — The name of the model to be used for the llm page filter model.
    - `LLM_PAGE_FILTER_TEMPERATURE` number — Temperature value for randomness.
    - `LLM_PAGE_FILTER_PROMPT` string
    - `LLM_SUMMARISE_MODEL_NAME` string — The name of the model to be used for the llm summarise model.
    - `LLM_SUMMARISE_TEMPERATURE` number — Temperature value for randomness.
    - `LLM_SUMMARISE_PROMPT` string
  - `AgentLLM` AgentLLMConfig
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `MODEL_NAME` string — The name of the model to be used.
    - `ENABLED` boolean — Whether to use agent mode for queries.
    - `MAX_ITERATIONS` integer — Maximum agent loop iterations.
    - `SHOW_INTERIM_STEPS` boolean — Whether to show agent's intermediate steps.
    - `MAX_CONTEXT_TOKENS` integer — Maximum tokens for gathered context (applies to evidence buffer and final query).
    - `SYSTEM_INSTRUCTION` string — The system instruction for agent planning.
    - `TEMPERATURE` number — Temperature for agent decisions.
    - `MAX_TOKENS` integer — Maximum tokens for planning decisions.
    - `MAX_CHAR_SIZE_TO_ANSWER` integer — Maximum character size for history.
  - `TitleLLM` TitleLLMConfig
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `MODEL_NAME` string — The name of the non-reasoning model to be used.
    - `SYSTEM_INSTRUCTION` string
    - `MAX_CHAR_SIZE_TO_ANSWER` integer — Maximum character size to answer.
    - `TEMPERATURE` number — Temperature value for randomness.
    - `MAX_TOKENS` integer — Maximum number of tokens allowed.
  - `DocumentDateExtractorLLM` DocumentDateExtractorLLMConfig
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `MODEL_NAME` string — The name of the non-reasoning model to be used.
    - `SYSTEM_INSTRUCTION` string
    - `MAX_CHAR_CONTEXT_TO_ANSWER` integer — Maximum characters in document for context.
    - `TEMPERATURE` number — Temperature value for randomness.
    - `MAX_TOKENS` integer — Maximum number of tokens allowed.
  - `ModelCitation` ModelCitationConfig
    - `SIM_THREASHOLD` number — How similar does the statement needs to be to be considered as citation.
    - `MIN_CHAR_SIZE_TO_ANSWER` integer — Minimum character length to be considered as a statement for citation.
    - `MAX_NUMB_CITATIONS` integer — Maximum number of citations to return per statement.
    - `SIM_MODEL_NAME` string — Name of the model to be used.
  - `Parser` ParserConfig
  - `Chunker` ChunkerConfig
  - `Embedder` EmbedderConfig
    - `MODEL_NAME` string — The name of the embedder model.
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `BATCH_SIZE` integer — Smaller batch size for better parallelization.
    - `MAX_CONCURRENT_REQUESTS` integer — Adjust concurrency level as needed.
    - `EMBED_PREFIX` string — How to embed the sentence for retrieval.
    - `QUERY_PREFIX` string — How to embed the sentence for query.
  - `Retriever` RetrieverConfig
    - `MIN_RETRIEVAL_SIM_SCORE` number — Minimum similarity score for retrieval of a chunk.
    - `MAX_DISTINCT_DOCUMENTS` integer — Maximum number of distinct documents to search for.
    - `MAX_TOTAL_CHUNKS_TO_RETRIEVE` integer — Maximum total number of chunks to retrieve for all documents retrieved.
    - `GROUP_SIZE` integer — Maximum number of chunks per document for retrieval.
  - `Reranker` RerankerConfig
    - `MAX_NUMB_OF_CHUNKS` integer — Maximum number of chunks to return after reranking.
    - `MODEL_NAME` string — Name of the reranking model to use.
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
  - `title` string
  - `parent_message_ext_id` string, nullable

## Response `200`

Successful Response

- ConfigSaveResponse — Response model for configuration save endpoint
  - `external_id` string, required
  - `title` string, nullable, required
  - `created_at` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2025-10-06** `8d3e894e6c0b` — 1 warning, 7 info
  - removed the request property `DocumentDateExtractorLLM/anyOf[subschema #1: DocumentDateExtractorLLMConfig]/MAX_CHAR_SIZE_TO_ANSWER`
  - added the new optional request property `AgentLLM`
  - added the new optional request property `Agents`
  - added the new optional request property `DocumentDateExtractorLLM/anyOf[subschema #1: DocumentDateExtractorLLMConfig]/MAX_CHAR_CONTEXT_TO_ANSWER`
  - …4 more
- **2025-08-19** `5287337ab0fe` — 1 breaking, 3 warning, 14 info
  - removed the required property `version` from the response with the `200` status
  - removed the request property `ModelCitation/anyOf[subschema #1: ModelCitationConfig]/MODEL_NAME`
  - removed the request property `filename_suffix`
  - removed the optional property `detail` from the response with the `200` status
  - …14 more
- **2025-08-06** `43c12480eb1b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/configs/post.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/8d3e894e6c0b/schema)