overlay: 1.0.0
info:
  title: API Evangelist enhancements for Kateeva SEO Metadata API
  version: 1.0.0
extends: openapi/kateeva-seo-api-openapi.yml
x-generated: '2026-08-23'
x-method: generated
x-note: Kateeva publishes no OpenAPI. The document this overlay extends was derived by API Evangelist from the server's
  own route index and HTTP OPTIONS schema documents. These actions record the enhancements API Evangelist added
  on top of that derivation — provenance, consumption guidance and cross-links to the artifacts in this repo — so
  the derived spec can be regenerated from the live host without losing them.
actions:
- target: $.info
  update:
    x-apievangelist-profile: https://github.com/api-evangelist/kateeva
    x-apievangelist-derived: route index + HTTP OPTIONS schema documents on https://kateeva.com/wp-json/, 2026-08-23
    x-apievangelist-provider-published-spec: false
    x-apievangelist-surface: Incidental WordPress REST content API behind a capital-equipment marketing site; not
      a product API.
- target: $.info
  update:
    x-artifacts:
      authentication: authentication/kateeva-authentication.yml
      errors: errors/kateeva-problem-types.yml
      conventions: conventions/kateeva-conventions.yml
      lifecycle: lifecycle/kateeva-lifecycle.yml
      rate_limits: rate-limits/kateeva-rate-limits.yml
      examples: examples/kateeva-examples.yml
      data_model: data-model/kateeva-data-model.yml
      conformance: conformance/kateeva-conformance.yml
- target: $.servers[0]
  update:
    x-anonymous-read: true
    x-write-requires: WordPress application password; no public issuance path.
- target: $.paths.*.get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      subject: optional
      token:
        max-ttl: 3600
      audit: none
    x-consumption-note: Send _fields to trim the response; an unfiltered posts page is ~5KB per record.