Skip to main content
POST
Choose which provider serves open-weight models several providers host: a preset or custom price/latency/reliability balance, fixed traffic shares, a pinned provider, exclusions, and stickiness (admins)

Authorizations

Authorization
string
header
required

A management token: minted by the OAuth flow (aireserve login, or an MCP client's Authenticate step) or on the portal Keys page under Management Keys. Inference API keys are refused.

Body

application/json
preset
enum<string>
required

Named preset, custom with explicit weights, or split with providerShares

Available options:
cheapest,
fastest,
most_reliable,
balanced,
custom,
split
clientId
string<uuid>

Target organization id — platform admins only; omit otherwise

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
weights
object

Required for preset custom; ignored for named presets (their table weights apply)

excludedProviders
string[]

Serving-provider slugs never to serve this org (deepinfra, baseten, together, novita)

Maximum array length: 12
keepConversationOnProvider
boolean
default:true

Keep a conversation on one provider (recommended); false re-decides every request

pinnedProvider
string | null

Pin a provider: always serve from this slug where it offers the model (the balance decides elsewhere). Omit to keep the org's current pin, null to clear it.

providerShares
object

Split traffic (preset split only): fixed shares per provider slug summing to 100, e.g. {"deepinfra": 60, "baseten": 40} (deepinfra, baseten, together, novita)

Response

Executed successfully (ok: true).

status
enum<string>
required
Available options:
executed
ok
boolean
required

Whether the operation succeeded.

summary
string
required

The consent line describing what was done, built from resolved labels.

message
string
required

Human-readable result line.

data
any

Operation payload (reads) or detail worth relaying (writes).

secret
string

A one-time secret the operation minted (API key, credential). Shown once; store it now.

sensitive
enum<boolean>

Present exactly when secret is: redact this response from logs.

Available options:
true