List Extract API Keys
averra_list_api_keysList all API keys for your authenticated account to view metadata, identify keys for management, and audit access permissions.
Instructions
List all API keys for the authenticated account.
Returns metadata only — the actual plaintext keys are never returned (only prefixes). Includes both active and revoked keys, ordered by creation date (newest first).
Args:
response_format ('markdown' | 'json', optional): Output format. Default 'markdown'.
Returns: For JSON format: { "keys": [ { "id": string, // Key ID (use for revoke operations) "key_prefix": string, // First 12 chars of key "plan": "free" | "starter" | "pro" | "scale", // Decorated from the account profile — identical across every key on the account. "monthly_limit": number, // Decorated from the account profile — identical across every key on the account. "is_active": boolean, // false if revoked "created_at": string, // ISO 8601 "revoked_at": string | null // ISO 8601 if revoked, null otherwise } ] }
Examples:
Use when: User asks "How many API keys do I have?"
Use when: Need to find a key's ID before revoking it.
Use when: Auditing which keys exist and their plans.
Error Handling:
401: Invalid API key — check AVERRA_EXTRACT_API_KEY
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| response_format | No | Output format: 'markdown' for human-readable output (default), 'json' for machine-readable structured data | markdown |