Skip to main content
PUT
Create or rotate a secret

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId
string
required
name
string
required

Body

application/json

Send value, agentAccess, or both. Sending neither is an error.

value
string

The credential to store. Write-only: no response ever returns it.

agentAccess
enum<string>

Whether an agent may spend this secret unattended. approval asks a person on each use; never refuses every agent. Omit to keep the stored setting. Only the owner can change it.

Available options:
auto,
approval,
never

Response

Successful response

The response is of type object.