Skip to main content
PUT
Replace a secret's stored body

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

name
string
required

The name the secret is stored under.

Body

application/json

PUT /v1/workspaces/{workspace_id}/secrets/{secret_name} — replace the body.

data
object
required

The complete replacement body.

Opaque for the same reason create's is: an unparsed slice in Rust, an object on the wire. value_type names the difference.

Response

OK

What a create and a replace both answer with.

One shape for both verbs because both say the same thing — which name now holds a secret — and the status code is what distinguishes them.

name
string
required

The name the secret is stored under.