paperclip_update_secret
Update a secret's metadata (name, description, external reference) without changing its value. Requires board-level API key.
Instructions
⚠ Board-only: Update secret metadata (name, description, externalRef). To rotate the secret value, use paperclip_rotate_secret.
Args:
secretId: string — Secret UUID
name: string (optional) — New secret name
description: string | null (optional) — New description (null to clear)
externalRef: string | null (optional) — New external reference (null to clear)
Returns: Updated secret metadata: id, companyId, name, provider, externalRef, latestVersion, description, timestamps. Value is never returned.
Examples:
Use when: renaming a secret or updating its description or external reference without changing its value
Don't use when: you need to change the secret value — the value field is not accepted here; use paperclip_rotate_secret instead
Error Handling:
404: secret not found → verify secretId with paperclip_list_secrets
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → this tool requires a board (human-user) API key
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| secretId | Yes | Secret UUID | |
| name | No | New secret name | |
| description | No | New description (null to clear) | |
| externalRef | No | New external reference (null to clear) |