ASasteroid
Secrets

Create Secret

Create a secret. The item key is derived from name unless itemKey is given. Secret values go to WorkOS; Postgres stores metadata and readable values only.

post/agents/v2/secrets

Request

  • Base URL
    https://odyssey.asteroid.ai
  • URL
    https://odyssey.asteroid.ai/agents/v2/secrets
  • Auth
    API key in header X-Api-Key

Headers

Idempotency-Keystring

A key unique within the organization. Reusing it returns the secret already created with that key instead of creating a second one.

Request body

itemKeystring

UPPER_SNAKE vault item key. Derived from name when omitted on create. Unique among a profile's attached items, not across the organisation. Stays the same across renames.

kind'login' | 'api_key' | 'card' | 'custom'

Kind of vault item. Templates and items need at least one field. Completeness is per-field required.

namestring required
organizationIdstring uuid
templateIdstring uuid

Response

The request has succeeded and a new resource has been created as a result.

createdAtstring date-time required
createdBystring uuid
idstring uuid required
itemKeystring required

UPPER_SNAKE vault item key. Derived from name when omitted on create. Unique among a profile's attached items, not across the organisation. Stays the same across renames.

kind'login' | 'api_key' | 'card' | 'custom' required

Kind of vault item. Templates and items need at least one field. Completeness is per-field required.

lastRotatedAtstring date-time
lastRotatedBystring uuid
lastUsedAtstring date-time
namestring required
organizationIdstring uuid required
templateIdstring uuid
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.