overlay: 1.0.0
info:
  title: API Evangelist enhancements for Jetpack AI-Plugin API
  version: 1.0.0
extends: openapi/automattic-jetpack-ai-plugin-openapi.yaml
actions:
- target: $.info
  update:
    x-apievangelist-provider: automattic
    x-apievangelist-generated: '2026-07-31'
    x-apievangelist-provenance: published verbatim by Automattic at https://public-api.wordpress.com/wpcom/v2/ai-plugin/openapi.yaml
    x-apievangelist-operation-count: 4
- target: $.info
  update:
    x-idempotency-supported: false
    x-idempotency-note: Automattic documents no idempotency key on any WordPress.com namespace. See conventions/automattic-conventions.yml.
- target: $.info
  update:
    x-error-format: vendor-json
    x-rfc9457: false
    x-error-catalog: errors/automattic-problem-types.yml
- target: $.info
  update:
    x-rate-limit-documented: false
    x-responsible-use-policy: https://developer.wordpress.com/docs/api/guidelines-for-responsible-use-of-automattics-apis/
- target: $.info
  update:
    x-artifacts:
      authentication: authentication/automattic-authentication.yml
      scopes: scopes/automattic-scopes.yml
      conventions: conventions/automattic-conventions.yml
      lifecycle: lifecycle/automattic-lifecycle.yml
      conformance: conformance/automattic-conformance.yml
      data_model: data-model/automattic-data-model.yml
      mcp: mcp/automattic-mcp.yml