---
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
    - `MODEL_NAME` string — The name of the model to be used.
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `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.
  - `TitleLLM` TitleLLMConfig
    - `MODEL_NAME` string — The name of the model to be used.
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `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
    - `MODEL_NAME` string — The name of the model to be used.
    - `API_TYPE` 'local' | 'remote' — The inference type (local or remote).
    - `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.
  - `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).
  - `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-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/84efd317dcde/schema)