Configuration endpoints

The config endpoint lets a client read the server’s media settings at runtime. GET /v1/config/multimodal returns the storage backend, the maximum upload size and the document handling strategy, so a UI can check limits before it uploads a file. It needs the config:read permission.

Get the multimodal configuration

GET /v1/config/multimodal returns the three media settings the server loaded from its environment. The request takes no parameters and no body. The values are read-only: you change them with environment variables and a server restart.

# Read the media configuration (replace $TOKEN with a valid bearer token)
curl http://127.0.0.1:8000/v1/config/multimodal \
  -H "Authorization: Bearer $TOKEN"

Example response. The metadata values shown in angle brackets vary per request.

{
  "data": {
    "media_storage_type": "local",
    "media_max_size_mb": 25.0,
    "document_handling": "extract_text"
  },
  "metadata": {
    "request_id": "<request id>",
    "timestamp": "<timestamp>",
    "message": "OK"
  }
}

Response fields

Each field in data maps to one environment variable on the server. The defaults apply when the variable is unset.

Error responses

The endpoint returns an error when the caller is not authenticated or lacks the permission.

Related

• File upload endpoints: upload files and fetch them by ID
• Files and multimodal on the server: storage backends, size limits and signed URLs
• Environment variables: every server setting