Update a provider

Updates a provider’s configuration. Expects ALL fields to be provided, including both edited and non-edited fields. Partial updates are not supported.

PUT /api/providers/{provider}

Error

A valid request URL is required to generate request examples

200

{
  "network_config": {
    "base_url": "<string>",
    "extra_headers": {},
    "default_request_timeout_in_seconds": 123,
    "max_retries": 123,
    "retry_backoff_initial": 123,
    "retry_backoff_max": 123,
    "insecure_skip_verify": true,
    "ca_cert_pem": "<string>",
    "allow_private_network": false
  },
  "concurrency_and_buffer_size": {
    "concurrency": 123,
    "buffer_size": 123
  },
  "proxy_config": {
    "url": "<string>",
    "username": "<string>",
    "password": "<string>",
    "ca_cert_pem": "<string>"
  },
  "send_back_raw_request": true,
  "send_back_raw_response": true,
  "store_raw_request_response": true,
  "custom_provider_config": {
    "is_key_less": true,
    "allowed_requests": {
      "list_models": true,
      "text_completion": true,
      "text_completion_stream": true,
      "chat_completion": true,
      "chat_completion_stream": true,
      "responses": true,
      "responses_stream": true,
      "count_tokens": true,
      "embedding": true,
      "speech": true,
      "speech_stream": true,
      "transcription": true,
      "transcription_stream": true,
      "image_generation": true,
      "image_generation_stream": true,
      "batch_create": true,
      "batch_list": true,
      "batch_retrieve": true,
      "batch_cancel": true,
      "batch_results": true,
      "file_upload": true,
      "file_list": true,
      "file_retrieve": true,
      "file_delete": true,
      "file_content": true
    },
    "request_path_overrides": {}
  },
  "status": "<string>",
  "description": "<string>",
  "config_hash": "<string>"
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

provider · string · required

Provider name

Body

application/json

Update provider request. Keys are managed separately via /api/providers/{provider}/keys.

network_config · object

Network configuration for provider connections

Show child attributes

concurrency_and_buffer_size · object

Concurrency settings

Show child attributes

proxy_config · object

Proxy configuration

Show child attributes

send_back_raw_request · boolean

send_back_raw_response · boolean

store_raw_request_response · boolean

custom_provider_config · object

Custom provider configuration

Show child attributes

Response

200

application/json

Provider updated successfully

Provider configuration response

name · enum<string>

AI model provider identifier

Available options: openai, azure, anthropic, bedrock, cohere, vertex, vllm, mistral, ollama, groq, sgl, parasail, perplexity, replicate, cerebras, gemini, openrouter, elevenlabs, huggingface, nebius, xai, runway, fireworks

network_config · object

Network configuration for provider connections

Show child attributes

concurrency_and_buffer_size · object

Concurrency settings

Show child attributes

proxy_config · object

Proxy configuration

Show child attributes

send_back_raw_request · boolean

send_back_raw_response · boolean

store_raw_request_response · boolean

custom_provider_config · object

Custom provider configuration

Show child attributes

provider_status · enum<string>

Status of the provider

Available options: active, error, deleted

status · string

Operational status (e.g., list_models_failed)

description · string

Error/status description

config_hash · string

Hash of config.json version, used for change detection