API Evangelist enhancements for CybelAngel Alerts API

# authorship: generated by API Evangelist tooling. Stamped 2026-08-18
# on the file's own generator header (roadmap#64). An unmarked file is
# NOT assumed to be ours -- absence of evidence was never stamped.
x-method: generated
overlay: 1.0.0
info:
  title: API Evangelist enhancements for CybelAngel Alerts API
  version: 1.0.0
  x-generated: '2026-08-17'
  x-method: generated
  x-source: >-
    Generated by the API Evangelist enrichment pipeline from the provider's own published
    specification, harvested verbatim from the Stoplight developer portal at
    developers.cybelangel.com. This overlay records API Evangelist's derived findings; the
    harvested specification in openapi/cybelangel-alerts-openapi.yml is never mutated.
extends: openapi/cybelangel-alerts-openapi.yml
actions:
  - target: $.info
    description: Attach the API Evangelist profile pointers for this API.
    update:
      x-apievangelist-profile: https://apis.io/provider/cybelangel
      x-apievangelist-repository: https://github.com/api-evangelist/cybelangel
      x-apievangelist-harvested: '2026-08-17'
      x-apievangelist-harvest-source: developers.cybelangel.com (Stoplight project export)
      x-apievangelist-base-url: https://api.cybelangel.com
      x-apievangelist-auth: http bearer JWT
  - target: $.info
    description: Cross-link the derived artifacts that describe the cross-cutting semantics this spec omits.
    update:
      x-apievangelist-artifacts:
        authentication: authentication/cybelangel-authentication.yml
        scopes: scopes/cybelangel-scopes.yml
        conventions: conventions/cybelangel-conventions.yml
        errors: errors/cybelangel-problem-types.yml
        rate_limits: rate-limits/cybelangel-rate-limits.yml
        lifecycle: lifecycle/cybelangel-lifecycle.yml
        data_model: data-model/cybelangel-data-model.yml
        conformance: conformance/cybelangel-conformance.yml
        sandbox: sandbox/cybelangel-sandbox.yml
        skills: skills/_index.yml
  - target: $.info
    description: Record the runtime facts the specification does not carry.
    update:
      x-apievangelist-runtime:
        token_endpoint: https://auth.cybelangel.com/oauth/token
        token_audience: https://platform.cybelangel.com/
        grant_type: client_credentials
        jwks_uri: https://auth.cybelangel.com/.well-known/jwks.json
        rate_limit_requests_per_second: 15
        rate_limit_concurrent_requests: 20
        rate_limit_tokens_per_month: 2000
        rate_limit_response_headers: none
        idempotency: not supported
        mock_server: https://stoplight.io/mocks/cybelangel
  - target: $.paths['/v1/alerts/{alert_id}/credentials'].get
    description: Flag the successor operation for the one deprecated operation in the estate.
    update:
      x-apievangelist-superseded-by: alerts_get_alert_credentials_alerts__alert_id__leak_credentials_get
      x-apievangelist-notes: >-
        Already deprecated: true in the provider's spec, and one of three Alerts operations that
        can return 410 Gone. No Sunset date is published.
  - target: $.paths['/v1/alerts'].get
    description: Record the documented response cap and retention window.
    update:
      x-apievangelist-notes:
        max_records_per_response: 1000
        retention: 'rolling 12 months; nothing before 2026-01-01'
        ordering: >-
          Ingestion is asynchronous, so the last few minutes of alerts may arrive out of sequence —
          overlap polling windows instead of advancing a strict watermark.