API Evangelist enhancements for Lytics API v2

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Lytics API v2
  version: 1.0.0
extends: openapi/lytics-api-v2-openapi.json
x-provenance:
  generated: '2026-08-13'
  method: generated
  source: openapi/lytics-api-v2-openapi.json
  note: >-
    Non-destructive enhancement layer over the VERBATIM harvested Lytics API v2 document
    (fetched from Lytics' own ReadMe API registry). The harvested spec is never mutated.
    This overlay records only what API Evangelist added on top: cross-links to the
    derived artifacts in this repo, and the observations a consumer needs before
    calling. The spec declares no operationId on any of its 1,331 operations.
    Sanitization: the enrichment pipeline's deterministic secret sanitizer replaced a
    secret-SHAPED example token inside a field DESCRIPTION in the harvested v2 document
    (a Slack incoming-webhook example URL) with a REDACTED_ placeholder, so GitHub
    push-protection does not block the repository. No schema, path, parameter or
    operation was altered.
actions:
  - target: $.info
    update:
      x-apievangelist-repository: https://github.com/api-evangelist/lytics
      x-apievangelist-artifacts:
        authentication: authentication/lytics-authentication.yml
        conventions: conventions/lytics-conventions.yml
        errors: errors/lytics-error-codes.yml
        lifecycle: lifecycle/lytics-lifecycle.yml
        rate-limits: rate-limits/lytics-rate-limits.yml
        data-model: data-model/lytics-data-model.yml
        plans: plans/lytics-plans-pricing.yml
        skills: skills/_index.yml
        tool-crosswalk: mcp/lytics-tool-crosswalk.yml
        webhooks: asyncapi/lytics-webhooks.yml
      x-apievangelist-observations:
        operation_ids: 1331 operations
        idempotency: not supported — no Idempotency-Key parameter or header in this document
        error_format: 'vendor JSON envelope {status, message, request_id}; NOT RFC 9457 problem+json'
        rate_limit_headers: none returned; 429 carries no RateLimit-* or Retry-After signal
        multi_account: account_id query parameter selects the account for a multi-account token
  - target: $.externalDocs
    update:
      description: Lytics API Reference
      url: https://docs.lytics.com/reference