Skip to main content
POST
Add a managed runtime provider credential

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Required for every non-open scope. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
agents
string

Comma-separated agent allowlist

authMethod
string

Auth method, e.g. claude-oauth, api-key, codex-profile

authProfile
string

Provider-native auth profile path

label
string

Human label that does not contain secrets

models
string

Comma-separated model allowlist

notes
string

Operator notes, without secrets

priority
string

Selection priority (higher first)

provider
string

Runtime provider id, e.g. claude, codex, pi, grok

readOnly
boolean

Mark the source as external/read-only in notes

remoteForward
boolean

Allow selected target env vars to be forwarded to remote workers

secretEnv
string

Comma-separated source env vars holding secrets

targetEnv
string

Comma-separated provider-facing env vars

taskProfiles
string

Comma-separated task profile allowlist

upstream
string

Upstream provider id, e.g. anthropic, openai

Response

Success — body conforms to the @Returns schema.

credential
object
required
{key}
any