Skip to main content

Secrets Commands

See Secrets module docs for permissions and data model.

soat list-secrets​

List secrets

  • Method: GET
  • Path: /api/v1/secrets

Usage​

soat list-secrets

Options​

--project-id​

Project ID (required if not using project key auth)

  • Source: query
  • Required: no
  • Type: string
  • Example: proj_V1StGXR8Z5jdHi6B

soat create-secret​

Create a secret

  • Method: POST
  • Path: /api/v1/secrets

Usage​

soat create-secret --name <string> --value <string>

Options​

--project-id​

Project ID (required if not using project key auth)

  • Source: body
  • Required: no
  • Type: string
  • Example: proj_V1StGXR8Z5jdHi6B
--name​

Secret name

  • Source: body
  • Required: yes
  • Type: string
  • Example: DATABASE_PASSWORD
--value​

Secret value (will be encrypted)

  • Source: body
  • Required: yes
  • Type: string
  • Example: supersecretpassword

soat get-secret​

Get a secret

  • Method: GET
  • Path: /api/v1/secrets/{secret_id}

Usage​

soat get-secret --secret-id <string>

Options​

--secret-id​

Secret ID

  • Source: path
  • Required: yes
  • Type: string
  • Example: sec_V1StGXR8Z5jdHi6B

soat update-secret​

Update a secret

  • Method: PATCH
  • Path: /api/v1/secrets/{secret_id}

Usage​

soat update-secret --secret-id <string>

Options​

--secret-id​

Secret ID

  • Source: path
  • Required: yes
  • Type: string
--name​

New secret name

  • Source: body
  • Required: no
  • Type: string
--value​

New secret value

  • Source: body
  • Required: no
  • Type: string

soat delete-secret​

Delete a secret

  • Method: DELETE
  • Path: /api/v1/secrets/{secret_id}

Usage​

soat delete-secret --secret-id <string>

Options​

--secret-id​

Secret ID

  • Source: path
  • Required: yes
  • Type: string
--force​

Delete the secret even when AI providers reference it, destroying those providers too. Without it a referenced secret answers SECRET_HAS_DEPENDENTS.

  • Source: query
  • Required: no
  • Type: boolean
  • Default: false