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.
descriptionstring nullable
Optional human-readable description of this configuration.
endpoint_urlstring nullable
Optional custom endpoint URL (e.g. for self-hosted or proxied providers). Leave unset to use the provider's default.
is_publicboolean
If True, the configuration is visible to all workspace members; otherwise it is scoped to the creator.
namestring required
Human-readable label for this provider configuration.
provider_spec_idstring uuid required
UUID of the provider specification (e.g. OpenAI, Anthropic) this configuration targets. Look up via list_specs.