API Evangelist overlay — AG Listings API

overlay: 1.0.0
info:
  title: API Evangelist overlay — AG Listings API
  version: 1.0.0
extends: general-services-administration-acquisition-gateway-listings-openapi.yaml
x-provenance:
  generated: '2026-09-12'
  method: generated
  source: Generated from openapi/general-services-administration-acquisition-gateway-listings-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://open.gsa.gov/api/ag-api/
      documentation: https://open.gsa.gov/api/ag-api/
      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: The published contract declares no server. This is the production base documented on https://open.gsa.gov/api/ag-api/.
  update:
    x-api-evangelist-production-server:
      url: https://api.gsa.gov/acquisitiongateway/api/v4.0
      declared_in_spec: []
      source: https://open.gsa.gov/api/ag-api/
- target: $.info
  description: 2 of the operations in this contract declare no operationId, so nothing can address them by name.
  update:
    x-api-evangelist-missing-operation-ids:
    - GET /{workgroup}?search={keyword}
    - GET /{workgroup}/resource/{pid}