curl --request POST \
  --url https://api.verlon.ai/v1/provider-keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apiKey": "<string>",
  "projectId": "<string>"
}
'

{
  "error": "<string>",
  "message": "<string>",
  "details": "<unknown>"
}

Provider Keys

Register a BYOK provider key

Use when: caller wants to store an OpenAI/Anthropic/Google/Mistral API key so Layer routes through the caller’s own provider account instead of pooled credentials

Registers an upstream provider API key (OpenAI / Anthropic / Google / Mistral) so Layer can route the caller’s traffic through their own account. The raw key is encrypted at rest with ENCRYPTION_KEY and never returned in subsequent reads. Conflicts with 409 if a key for the same provider already exists; use PUT to update.

POST

provider-keys

curl --request POST \
  --url https://api.verlon.ai/v1/provider-keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apiKey": "<string>",
  "projectId": "<string>"
}
'

{
  "error": "<string>",
  "message": "<string>",
  "details": "<unknown>"
}

Authorizations

Authorization

string

header

required

Layer API key (prefixed sk-). Generated from the dashboard under Settings → API Keys, or via layer key create in the CLI.

Body

application/json

provider

enum<string>

required

Available options:

openai,

anthropic,

google,

mistral

apiKey

string

required

Minimum string length: 1

projectId

string | null

Response

Provider key registered.

List BYOK provider keys Update a BYOK provider key

Documentation Index

Authorizations

Body

Response