Skip to main content
POST
Create a private provider

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Body

application/json

A private provider serves only your organization, so its endpoints are recorded as retaining no prompts, training on none and publishing none, and pass every data-policy filter your account or guardrails apply.

name
string
required

Provider name, shown in your activity, logs and Broadcast output. 2-64 letters, numbers, spaces, dots, underscores or hyphens. Cannot be changed later. Neither the name nor its slug may match a public provider name or slug (case-insensitive); other customers may use the same name.

Required string length: 2 - 64
Pattern: ^[A-Za-z0-9][A-Za-z0-9 ._-]*$
Example:

"Acme"

base_url
string

HTTPS base URL of an OpenAI-compatible API, used by private endpoints under this provider that set no URL of their own. Without it, each endpoint must set its own. Private, internal, metadata and OpenRouter hosts are rejected.

Minimum string length: 1
Example:

"https://inference.example.com/v1"

display_name
string

Defaults to name.

Required string length: 1 - 80
Example:

"Acme"

slug
string

2-64 lowercase letters and numbers, separated by single hyphens. Cannot be changed later. Defaults to the name lowercased, with every run of other characters replaced by a hyphen (Acme Inference becomes acme-inference).

Required string length: 2 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"acme"

Response

The provider was created

data
object
required
Example: