Skip to main content
PUT
Rotate Secret

Authorizations

Authorization
string
header
required

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

Path Parameters

secret_id
string<uuid>
required
workspace
string
required

Slug of the workspace the request acts in

Maximum string length: 120
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Body

application/json
value
string
required

Replaces the stored value.

Minimum string length: 1

Response

Successful Response

A secret's metadata. The value is never part of this.

id
string<uuid>
required
name
string
required

Unique within the workspace.

created_at
string | null
description
string | null
owner
SecretOwner · object | null

Set when a connection holds this secret on the user's behalf. Such a secret is read-only here and is changed through its owner.

updated_at
string | null
used_by
SecretConsumer · object[]
Last modified on October 12, 2026