overlay: 1.0.0
info:
  title: API Evangelist overlay — Touchpoints API Reference
  version: 1.0.0
extends: general-services-administration-touchpoints-openapi.yaml
x-provenance:
  generated: '2026-09-12'
  method: generated
  source: Generated from openapi/general-services-administration-touchpoints-openapi.yaml plus the artifacts in
    this repository. The original contract is never mutated.
actions:
- target: $.info
  description: Record API Evangelist provenance and the operating facts the contract does not carry.
  update:
    x-api-evangelist:
      provider: General Services Administration
      providerId: general-services-administration
      harvested: '2026-09-12'
      harvested_from: https://touchpoints.digital.gov/api-reference
      documentation: https://touchpoints.digital.gov/api-reference
      authentication: authentication/general-services-administration-authentication.yml
      rate_limits: rate-limits/general-services-administration-rate-limits.yml
      errors: errors/general-services-administration-problem-types.yml
      conventions: conventions/general-services-administration-conventions.yml
- target: $
  description: Documented production base URL.
  update:
    x-api-evangelist-production-server:
      url: https://api.gsa.gov/analytics/touchpoints/v1
      declared_in_spec:
      - https://api.gsa.gov/analytics/touchpoints/v1
      source: https://touchpoints.digital.gov/api-reference
- target: $.info
  description: 10 of the operations in this contract declare no operationId, so nothing can address them by name.
  update:
    x-api-evangelist-missing-operation-ids:
    - GET /cx_collection_details
    - GET /cx_collections
    - GET /cx_responses
    - GET /forms
    - GET /forms/{uuid}
    - GET /forms/{uuid}/responses
    - GET /service_providers
    - GET /services
    - GET /services/{id}
    - GET /websites