Skip to main content
POST
Create or Update Provider

Authorizations

Authorization
string
header
required

A control-plane management key using the sk-cp- prefix. Inference keys are not accepted by control-plane endpoints.

Body

application/json

An upstream provider endpoint and its request-profile settings.

provider_id
string
required

Provider name, e.g. openai

Required string length: 1 - 63
Pattern: ^[a-z0-9][a-z0-9_-]*$
base_url
string<uri>
required

OpenAI-compatible endpoint, e.g. https://api.groq.com/openai/v1

Required string length: 1 - 2083
kind
string
default:openai_compatible

Adapter kind

Required string length: 1 - 63
Pattern: ^[a-z0-9][a-z0-9_]*$
icon
string
default:""

Provider mark as a standalone 24x24 SVG document, or an empty string when no icon is available. Clients must sanitize this untrusted markup before rendering it

Maximum string length: 65536
param_aliases
Param Aliases · object

Canonical param name to this provider's spelling

accepted_params
string[] | null

Params known accepted beyond the core; consulted when params_closed

Maximum array length: 256
params_closed
boolean
default:false

True when the provider's request schema rejects unknown params

Response

Successful Response

data
ProviderOut · object
required