overlay: 1.0.0
info:
  title: API Evangelist enhancements for CapacityAuction
  version: 1.0.0
extends: openapi/aemo-capacityAuction-v1-openapi.yml
actions:
- target: $.servers
  description: Replace AEMO's internal api-prd.aemo.local server with the reachable production and pre-production
    gateway entry points AEMO documents at https://dev.aemo.com.au/oauth, combined with this API's published Azure
    API Management path.
  update:
  - url: https://api.aemo.com.au/ws/gsh/capacityAuction
    description: Production e-Hub API gateway.
  - url: https://api.preprod.wgw.aemo.com.au/ws/gsh/capacityAuction
    description: Pre-production e-Hub API gateway.
- target: $.info
  description: Record API Evangelist provenance and the enrichment artifacts that describe this API.
  update:
    x-apievangelist-provider: aemo
    x-apievangelist-enriched: '2026-07-27'
    x-apievangelist-artifacts:
      authentication: authentication/aemo-authentication.yml
      conventions: conventions/aemo-conventions.yml
      errors: errors/aemo-error-codes.yml
      lifecycle: lifecycle/aemo-lifecycle.yml
      rate_limits: rate-limits/aemo-rate-limits.yml
      conformance: conformance/aemo-conformance.yml
      vocabulary: vocabulary/aemo-glossary.yml
      agentic_access: agentic-access/aemo-agentic-access.yml
- target: $.info
  description: Bind this document to its source entry in AEMO’s Azure API Management catalogue.
  update:
    x-apievangelist-source:
      apim_api_id: capacityAuction-v1
      catalogue: https://dev.aemo.com.au/developer/apis?api-version=2022-04-01-preview
      operations: https://dev.aemo.com.au/developer/apis/capacityAuction-v1/operations?api-version=2022-04-01-preview
      reference: https://dev.aemo.com.au/api-docs
      gateway_path: ws/gsh/capacityAuction
      note: AEMO’s openapi-link export ships an empty paths object; the operations, parameters, headers, responses
        and examples in this document were harvested from AEMO’s own developer-portal operations endpoints.
- target: $.info
  description: Record the measured contract shape of this document as harvested.
  update:
    x-apievangelist-contract:
      operations: 5
      operations_with_description: 5
      operations_with_response_examples: 5
      soap_action_operations: 0
      components_schemas: 0
      idempotency_key: false