Skip to main content
POST
Create a provider credential
The key value is write-only. Phaseo encrypts it immediately and never returns it in API responses.
Use routing_mode: "priority" to try the credential before managed capacity, or "fallback" to try it afterward. Configure byokFallbackEnabled through workspace settings to control whether failed priority credentials may fall back to managed capacity.

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
provider
string
required
name
string
required
Required string length: 1 - 255
key
string
required
write-only

Raw credential. Encrypted and never returned.

Minimum string length: 1
enabled
boolean
default:true
routing_mode
enum<string>
Available options:
priority,
fallback
allowed_models
string[]
Maximum array length: 256
allowed_api_key_ids
string<uuid>[]
Maximum array length: 256

Response

Provider credential created

data
object
required
Last modified on August 30, 2026