Skip to main content
PUT
Create or rotate a provider

Authorizations

Authorization
string
header
required

A wandb API key or wandb JWT. Browser sessions are exchanged by the Model Distillation web app backend; job capabilities are internal only.

Headers

Wandb-Entity
string

Accessible personal or team entity. Omit to use the authenticated user's default entity.

Path Parameters

provider
string
required
Pattern: ^[a-z0-9][a-z0-9_-]{0,63}$

Query Parameters

validate_only
enum<string>

Validate these provider settings without saving them.

Available options:
true,
false

Body

application/json
base_url
string<uri>
required

OpenAI-compatible provider base URL. It must use HTTPS, and defaults to HTTPS when no scheme is supplied.

api_key
string
required

Provider API key, sent upstream as Authorization: Bearer <api_key>. Leading and trailing whitespace is removed; the remaining value must be printable ASCII with no spaces.

Minimum string length: 1
Pattern: ^[\x21-\x7e]+$
local_only
boolean
default:false
validation_model
string

When supplied, a minimal request to this model must succeed before the credential is saved. Omit to skip validation.

Required string length: 1 - 500

Response

Provider is already applied.

name
string
required
entity
string
required
base_url
string<uri>
required
credential_mode
enum<string>
required
Available options:
stored,
passthrough
masked_key
string
required
local_only
boolean
required
revision
integer
required
check
object
required
deployments
object[]
required
models
object[]
required
Last modified on September 30, 2026