Rest APIAPI ReferenceLlm Provider Key

Store LLM Provider's ApiKey

Store LLM Provider's ApiKey

Request

This endpoint expects an object.
providerenumRequired
api_keystringOptional
namestringOptional0-150 characters
provider_namestringOptional0-150 characters

Provider name - required for custom LLM and Bedrock providers to uniquely identify them (e.g., ‘ollama’, ‘vllm’, ‘Bedrock us-east-1’). Must not be blank for custom and Bedrock providers. Should not be set for standard providers (OpenAI, Anthropic, etc.). This requirement is conditional and validation is enforced programmatically.

headersmap from strings to stringsOptional
configurationmap from strings to stringsOptional
base_urlstringOptionalformat: "(?s)^\s*(\S.*\S|\S)\s*$"
auth_configobjectOptional

Dynamic token auth recipe. When set, Opik fetches a short-lived bearer from the configured auth service instead of using a static api_key. Only supported for custom providers. Secret credential values read back masked.

Response headers

LocationstringOptional

Response

Created

Errors

401
Unauthorized Error
403
Forbidden Error