Skip to main content
POST
Create an LLM config

Authorizations

Authorization
string
header
required

Session JWT. After nasiko auth login, print it with jq -r '.clusters[.active].token' ~/.nasiko/config.json. API keys aren't supported.

Body

application/json
name
string
required
provider
string
required
api_key_secret_name
string | null

Name of your secret that holds the provider API key. Omit it to use the server's provider key.

confirm_embedding_change
boolean

Accepted for client uniformity and ignored: a create has no previous embedding model, so there is never anything to confirm.

embedding_api_key_secret_name
string | null
embedding_model
string | null
embedding_model_override
boolean

When true, this config's embedding_model outranks the model an agent names on its own POST /v1/embeddings request.

embedding_provider
string | null

Embedding destination — independent of the chat provider/model above. Set the provider and model together or not at all; the secret name is optional and means "use the platform key for this provider" when absent.

embedding_secret_value
string | null

Plaintext key to store under embedding_api_key_secret_name when no such secret exists yet — the embedding-side twin of secret_value.

fallback_models
string[]
is_default
boolean

Mark this as the caller's default (clears any prior default).

max_tokens
integer<int64> | null
model
string | null
pinned
boolean
pinned_model
string | null
secret_value
string | null

Plaintext key to store under api_key_secret_name when no such secret exists yet. Required when the named secret is absent; ignored (as an upsert) when it already exists.

temperature
number<double> | null
tier1_model
string | null

Per-config tier-to-model override. When set, the LLM router uses it instead of the model registry for this config's provider.

tier2_model
string | null
tier3_model
string | null

Response

data is the created config object (id, name, provider, model, fallback_models, temperature, max_tokens, api_key_secret_name, pinned, pinned_model, tier1_model, tier2_model, tier3_model, embedding_provider, embedding_model, embedding_api_key_secret_name, embedding_model_override, is_default, created_at, updated_at)

Standard MCP response envelope: {"data": …, "status_code": N, "message": "…"}. data is a free-form object; each route's response description says what it contains.

data
object | null
required
message
string
required
status_code
integer<int32>
required
Required range: x >= 0
Example:

200