WayloAIWaylo Docs
APIReferenceProvider keys

Set provider key

PUT
/provider-keys/{provider}

Add or replace the tenant’s key for a provider. The key is checked against the provider and stored whatever the answer, with the result in status: a key that fails the check is flagged, not refused. 503 when credential encryption is not configured.

Access: tenant_admin · API key provider_keys:write

Authorization

api-key
headerAuthorizationBearer <sk_waylo_<lookup><secret><checksum>>

Path Parameters

provider*string
Value in"openai""deepgram""cartesia"

Header Parameters

Authorization*string

Your API key.

Request Body

application/json
  1. body
apiKey*string
Match^[\x21-\x7e]+$
Length8 <= length <= 4096

Response Body

Saved

application/json
  1. response
provider*string
Value in"openai""deepgram""cartesia"
keyHint*string
status*string
Value in"valid""invalid""quota_exceeded""unverified"
statusReason*string|null
lastValidatedAt*|
Formatdate-time
updatedByUserId*|
Formatuuid
updatedByUserName*string|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
Example Request
curl -X PUT 'https://api.poc.app.waylovoice.ai/provider-keys/openai' \  -H 'Authorization: Bearer sk_waylo_...' \  -H 'Content-Type: application/json' \  -d '{  "apiKey": "stringst"}'
Example Response
{  "provider": "openai",  "keyHint": "string",  "status": "valid",  "statusReason": "string",  "lastValidatedAt": "2019-08-24T14:15:22Z",  "updatedByUserId": "b38eaad7-8efa-49e7-b0aa-619916a3821e",  "updatedByUserName": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

List provider keys GET

The tenant’s own provider keys and its failure mode. A key is shown by its last four characters only; the key itself is never returned. **Access:** tenant_admin · API key `provider_keys:read`

Update key settings PUT

Set what a stage does when the tenant’s key fails or is known bad. `strict` never runs that provider on the platform key; `failover` does. **Access:** tenant_admin · API key `provider_keys:write`