# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Anthropic Vaults API version: 1.0.0 extends: openapi/anthropic-vaults-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 13 - target: $.paths['/v1/vaults/{vault_id}/archive?beta=true'].post update: x-apievangelist-phrasing: intent: Archive a credential vault effect: write questions: - How do I archive a vault I no longer want agents to use? - Can I retire a whole vault without deleting it? instructions: - text: Archive vault {vault_id}. slots: vault_id: path.vault_id - text: Retire vault {vault_id} but keep it on record. slots: vault_id: path.vault_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials/{credential_id}/archive?beta=true'].post update: x-apievangelist-phrasing: intent: Archive a credential in a vault effect: write questions: - Can I archive one credential in a vault instead of deleting it? - What's the way to retire a single stored credential while keeping its history? instructions: - text: Archive credential {credential_id} in vault {vault_id}. slots: credential_id: path.credential_id vault_id: path.vault_id - text: Retire vault {vault_id} credential {credential_id} without erasing it. slots: vault_id: path.vault_id credential_id: path.credential_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate?beta=true'].post update: x-apievangelist-phrasing: intent: Validate an MCP OAuth credential effect: read questions: - How do I check that a stored MCP OAuth credential still works? - Can I test a vault credential against its MCP server before an agent uses it? instructions: - text: Validate the MCP OAuth credential {credential_id} in vault {vault_id}. slots: credential_id: path.credential_id vault_id: path.vault_id - text: Test whether vault {vault_id} credential {credential_id} can still authenticate to its MCP server. slots: vault_id: path.vault_id credential_id: path.credential_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].get update: x-apievangelist-phrasing: intent: Get a credential stored in a vault effect: read questions: - What details can I see about one credential stored in a vault? - Can I look up a vault credential's display name and metadata? instructions: - text: Get credential {credential_id} from vault {vault_id}. slots: credential_id: path.credential_id vault_id: path.vault_id - text: Show me vault {vault_id} credential {credential_id}. slots: vault_id: path.vault_id credential_id: path.credential_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].post update: x-apievangelist-phrasing: intent: Update a vault credential's auth or name effect: write questions: - How do I replace the secret or auth details on an existing vault credential? - Can I rename a credential or change its metadata? instructions: - text: Replace the auth on credential {credential_id} in vault {vault_id} with {auth}. slots: credential_id: path.credential_id vault_id: path.vault_id auth: requestBody.auth - text: Rename vault {vault_id} credential {credential_id} to {display_name}. slots: vault_id: path.vault_id credential_id: path.credential_id display_name: requestBody.display_name method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].delete update: x-apievangelist-phrasing: intent: Delete a credential from a vault effect: destructive questions: - How do I permanently delete a credential from a vault? - Is deleting a vault credential reversible? instructions: - text: Delete credential {credential_id} from vault {vault_id}. slots: credential_id: path.credential_id vault_id: path.vault_id - text: Permanently erase vault {vault_id} credential {credential_id}. slots: vault_id: path.vault_id credential_id: path.credential_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials?beta=true'].get update: x-apievangelist-phrasing: intent: List the credentials in a vault effect: read questions: - Which credentials are stored in my vault? - Can I include archived credentials when listing a vault's contents? instructions: - text: List the credentials in vault {vault_id}. slots: vault_id: path.vault_id - text: Show all credentials in vault {vault_id}, archived included {include_archived}. slots: vault_id: path.vault_id include_archived: query.include_archived method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}/credentials?beta=true'].post update: x-apievangelist-phrasing: intent: Store a new credential in a vault effect: write questions: - How do I add a new credential to a vault for my agents to use? - Can I name a credential when I store it? instructions: - text: Add credential {auth} to vault {vault_id}. slots: auth: requestBody.auth vault_id: path.vault_id - text: Store a new credential called {display_name} with auth {auth} in vault {vault_id}. slots: display_name: requestBody.display_name auth: requestBody.auth vault_id: path.vault_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}?beta=true'].get update: x-apievangelist-phrasing: intent: Get a vault's details effect: read questions: - What information is kept about a vault itself? - Can I look up one vault by its ID? instructions: - text: Get vault {vault_id}. slots: vault_id: path.vault_id - text: Show the name and metadata of vault {vault_id}. slots: vault_id: path.vault_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}?beta=true'].post update: x-apievangelist-phrasing: intent: Rename a vault or change its metadata effect: write questions: - Can I rename a vault after creating it? - Where do I change a vault's metadata? instructions: - text: Rename vault {vault_id} to {display_name}. slots: vault_id: path.vault_id display_name: requestBody.display_name - text: Set metadata {metadata} on vault {vault_id}. slots: metadata: requestBody.metadata vault_id: path.vault_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults/{vault_id}?beta=true'].delete update: x-apievangelist-phrasing: intent: Delete a vault effect: destructive questions: - How do I permanently delete a vault? - Is there a way to remove a vault entirely rather than archive it? instructions: - text: Delete vault {vault_id}. slots: vault_id: path.vault_id - text: Permanently remove vault {vault_id} and everything in it. slots: vault_id: path.vault_id method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults?beta=true'].get update: x-apievangelist-phrasing: intent: List my credential vaults effect: read questions: - Which vaults exist in my account? - Can I list archived vaults as well as active ones? instructions: - text: List my vaults. - text: Show {limit} vaults per page, archived ones included {include_archived}. slots: limit: query.limit include_archived: query.include_archived method: generated generated: '2026-09-26' - target: $.paths['/v1/vaults?beta=true'].post update: x-apievangelist-phrasing: intent: Create a vault for agent credentials effect: write questions: - How do I create a place to keep credentials my agents can use? - What do I need to provide to set up a new vault? instructions: - text: Create a vault named {display_name}. slots: display_name: requestBody.display_name - text: Set up vault {display_name} with metadata {metadata}. slots: display_name: requestBody.display_name metadata: requestBody.metadata method: generated generated: '2026-09-26'