Anthropic · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Anthropic Vaults API

14 actions 14 updates phrasing extends openapi/anthropic-vaults-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Anthropic's API. It is a proposal applied on top of the contract, not a document Anthropic publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 14

$.info
$.paths['/v1/vaults/{vault_id}/archive?beta=true'].post
$.paths['/v1/vaults/{vault_id}/credentials/{credential_id}/archive?beta=true'].post
$.paths['/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate?beta=true'].post
$.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].get
$.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].post
$.paths['/v1/vaults/{vault_id}/credentials/{credential_id}?beta=true'].delete
$.paths['/v1/vaults/{vault_id}/credentials?beta=true'].get
$.paths['/v1/vaults/{vault_id}/credentials?beta=true'].post
$.paths['/v1/vaults/{vault_id}?beta=true'].get
$.paths['/v1/vaults/{vault_id}?beta=true'].post
$.paths['/v1/vaults/{vault_id}?beta=true'].delete
$.paths['/v1/vaults?beta=true'].get
$.paths['/v1/vaults?beta=true'].post

OpenAPI Overlay

Raw ↑ 
# 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'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/anthropic-vaults-api-phrasing-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.