paperclip_list_secrets
List all registered secrets for a company and view their metadata without exposing secret values. Enables auditing of secret configurations with pagination support.
Instructions
⚠ Board-only: List secrets registered for a company. Returns metadata only — secret values are never included in any response.
Args:
companyId: string — Company UUID
limit: number (optional) — Max results per page (1–100, default 50)
offset: number (optional) — Number of records to skip (default 0)
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Pagination envelope { items: Secret[], total, count, offset, limit, has_more, next_offset }. Each item: id, companyId, name, provider, externalRef, latestVersion, description, createdByAgentId, createdByUserId, createdAt, updatedAt. Value field is never present.
Examples:
Use when: auditing which secrets are registered for a company or checking a specific secret's metadata
Don't use when: you need to rotate or update a secret — use paperclip_rotate_secret or paperclip_update_secret instead
Error Handling:
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 |
|---|---|---|---|
| companyId | Yes | Company UUID | |
| limit | Yes | Max secrets per page (1–100, default 50) | |
| offset | Yes | Number of secrets to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |