overlay: 1.0.0
info:
  title: API Evangelist enhancements for the DialNexa API
  version: 1.0.0
  x-generated: '2026-09-03'
  x-method: generated
  x-source: probes + provider docs, 2026-09-03
extends: openapi/_original/dialnexa-openapi.json
actions:
- target: $.info
  update:
    x-rate-limit-observed:
      headers: [x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset]
      observed: 'x-ratelimit-limit: 150, x-ratelimit-reset: 60 on api.dialnexa.com (probed 2026-09-03)'
      note: No numeric limits are published in the docs; 429 responses may carry Retry-After.
    x-error-envelope:
      shape: '{statusCode, message, error}'
      docs: https://dialnexa.com/docs/api-reference/errors
    x-idempotency:
      coverage: none
      note: 'Provider-stated: no platform-wide idempotency header; use correlation metadata and list-reconcile after timeouts.'
    x-pagination:
      note: Envelopes are per-endpoint and non-standardized; see https://dialnexa.com/docs/api-reference/pagination
- target: $.info
  update:
    x-mcp-server:
      endpoint: https://api.dialnexa.com/v1/mcp
      auth: OAuth 2.1 (PKCE) or Bearer API key
      docs: https://dialnexa.com/docs/mcp-tools/overview
- target: $.components.securitySchemes.bearer
  update:
    description: >-
      Workspace API key sent as the Bearer token. The key is a key_id:secret pair shown once at
      creation in Dashboard -> Settings -> API Keys; send the full value. Missing/revoked keys
      return 401 with the standard error envelope.