Skip to main content
POST
Create Provider Config

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Payload for creating an LLM provider configuration.

name
string
required

Human-readable label for this provider configuration.

Required string length: 1 - 255
provider_spec_id
string<uuid>
required

UUID of the provider specification (e.g. OpenAI, Anthropic) this configuration targets. Look up via list_specs.

api_key
string | null

Secret API key for the provider. Stored encrypted in the secret manager; never returned in responses. May be empty for proxies that accept keyless traffic — the backend suppresses the Authorization header when this is empty.

description
string | null

Optional human-readable description of this configuration.

Maximum string length: 1000
endpoint_url
string | null

Optional custom endpoint URL (e.g. for self-hosted or proxied providers). Leave unset to use the provider's default.

is_public
boolean
default:false

If True, the configuration is visible to all workspace members; otherwise it is scoped to the creator.

Response

Successful Response

created_at
string
required
created_by
string
required
endpoint_url
string | null
required
id
string
required
is_active
boolean
required
is_public
boolean
required
name
string
required
provider_spec_id
string
required
updated_at
string
required
workspace_id
string
required
model_instance_ids
string[]
provider_spec_key
string | null
provider_spec_name
string | null