Agentcard · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Agentcard v2 API

3 actions 3 updates update extends openapi/agentcard-openapi-original.json

Authorship not recorded No authorship marker is recorded for this file. It is not presented as the provider's.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-ratingx-apievangelist-notesx-artifactsx-agentic-accessx-idempotentx-idempotency-note

Targets 2

$.info

$.paths['/api/v2/connect/consent'].post

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Agentcard v2 API
  version: 1.0.0
extends: openapi/agentcard-openapi-original.json
actions:
- target: $.info
  update:
    x-apievangelist-rating: 4
    x-apievangelist-notes: >-
      Card-issuing payments API for AI agents. Single host, credential-scoped sandbox/live
      split. Bearer platform token (client-credentials); end-user access via OAuth 2.1 + PKCE
      on mcp.agentcard.sh. Custom stable-code error envelope (not RFC 9457). Idempotent
      connect/consent. HMAC-signed webhooks. Hosted MCP server + two first-party CLIs.
    x-artifacts:
      authentication: authentication/agentcard-authentication.yml
      conventions: conventions/agentcard-conventions.yml
      errors: errors/agentcard-problem-types.yml
      sandbox: sandbox/agentcard-sandbox.yml
      webhooks: asyncapi/agentcard-webhooks.yml
      mcp: mcp/agentcard-mcp.yml
      data_model: data-model/agentcard-data-model.yml
- target: $.info
  update:
    x-agentic-access: agentic-access/agentcard-agentic-access.yml
- target: $.paths['/api/v2/connect/consent'].post
  update:
    x-idempotent: true
    x-idempotency-note: Idempotent per user — a repeat call updates the same consent record.