API Evangelist enhancements for the Omni Status Services API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Omni Status Services API
  version: 1.0.0
extends: openapi/optus-services-api-openapi.yml
x-apievangelist:
  generated: '2026-10-21'
  method: generated
  source: openapi/optus-services-api-openapi.yml + overlays carried forward from the 2026-07-25 overlays
    on openapi/_original/ (status)
  note: Additive only; never mutates the extended document. Actions whose targets no longer exist in the
    split document were dropped, Swagger 2.0 $.definitions targets were rebased to $.components.schemas,
    and operationId updates were removed because the split document already declares its own operationIds.
actions:
- target: $.info
  update:
    x-apievangelist-provider: optus
    x-apievangelist-repo: https://github.com/api-evangelist/optus
    x-white-label-operator: Modica Group
    x-apievangelist-note: Title, contact and server in the original document all name Modica Group. The
      API is nonetheless live and callable on the Optus host.
- target: $.paths['/services'].get
  update:
    summary: List the service names the health API can report on
    x-apievangelist-note: Provider spec declares no operationId; this id is an API Evangelist convention.
    x-action-class: connected
    x-consequence: read
    x-observed-values:
      probed: '2026-07-25'
      services:
      - https
      - rest
      - soap
      - smpp
      - restv2
      - email2sms
      note: Live response from https://api.sms.optus.com.au/rest/services/v1/services. Service names are
        case-sensitive; an unsupported or wrongly cased name returns status "unknown".
- target: $.info
  update:
    x-related-status-surface:
      status_page: https://status.sms.optus.com.au/
      statuspage_api: https://status.sms.optus.com.au/api/v2/summary.json
      components_tracked: 17
      artifact: lifecycle/optus-lifecycle.yml