Skip to main content
DELETE
JavaScript
Remove a tool set secret from one tool set.
Deleting is not idempotent: a second delete of the same id is a 404.

What resolves after it is gone

Because a tool set secret is an override, deleting it does not necessarily break a ${NAME} reference, it falls through to the next scope. If a workspace secret of the same name exists, the tool set’s ${NAME} now resolves to that instead. If none does, the reference stops resolving, and the tool call fails at call time. So deleting a tool set secret is how you drop a per-tool-set override and let the workspace default take back over. To change the value rather than remove the override, rotate it in place.

Update a tool set secret

Rotate instead of delete, to keep the override.

List tool set secrets

See what overrides remain.

Store and use secrets

How a reference falls through the scopes.

Authorizations

Authorization
string
header
required

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

Path Parameters

workspaceId
string
required

The workspace that owns the tool set.

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

toolSetId
string
required

The tool set the secret belongs to. Accepts the canonical ts_… form or the external_id: form.

Example:

"toolset_01HXKD2E5NQM3T9AYWCFNRMN74"

id
string
required

The secret to delete.

Example:

"toolsecret_01HXKD2E5NQM3T9AYWCF8PWC4R"

Response