Skip to content
UltimateTeam.ai Docs

Store a vault entry

POST
/api/v1/vault/{agent_role}/entries

Encrypt and store a secret value in the agent’s vault partition.

Authorizations

Parameters

Path Parameters

agent_role
required
string

Request Body required

Request model for storing a new vault entry.

object
description
Any of:
string
<= 500 characters
entry_key
required

Logical key for the vault entry (e.g. ‘stripe_api_key’)

string
<= 255 characters
entry_type
required

Category of the stored data

string
Allowed values: credential parameter preference
value
required

The secret data to encrypt and store

object
key
additional properties
any

Responses

201

Successful Response

Response model for vault entry metadata (no decrypted value).

object
created_at
required
string format: date-time
description
required
Any of:
string
entry_key
required
string
entry_type
required
string
id
required
string format: uuid
updated_at
required
string format: date-time

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string