Calyptia · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Calyptia Cloud API

4 actions 4 updates documentation extends openapi/calyptia-cloud-openapi-original.yml

Authorship not recorded No authorship marker is recorded for this file. It is not presented as the provider's.

View Overlay File View on GitHub Overlay Specification

What the actions change

descriptionx-apievangelist-enrichedx-apievangelist-providerx-apievangelist-parent-companyx-api-status-pagex-api-referencex-apievangelist-conventions

Targets 3

$.info

$.components.securitySchemes.project

$.components.securitySchemes.auth0

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Calyptia Cloud API
  version: 1.0.0
extends: openapi/calyptia-cloud-openapi-original.yml
actions:
  - target: $.info
    update:
      x-apievangelist-enriched: '2026-07-18'
      x-apievangelist-provider: calyptia
      x-apievangelist-parent-company: chronosphere
      x-api-status-page: https://status.calyptia.com/
      x-api-reference: https://docs.calyptia.com/docs/calyptia-cloud-api/api-reference
  - target: $.components.securitySchemes.project
    update:
      description: >-
        Project API token issued from the Calyptia Cloud web UI
        (core.calyptia.com / project Settings). Primary auth for most operations.
  - target: $.components.securitySchemes.auth0
    update:
      description: >-
        Auth0 tenant (sso.calyptia.com). OIDC discovery at
        https://sso.calyptia.com/.well-known/openid-configuration.
        Scope maps are empty; API authorization is coarse-grained via project token.
  - target: $.info
    update:
      x-apievangelist-conventions:
        pagination: cursor (last + before/after -> endCursor)
        error_envelope: '{ "error": string } (not RFC 9457)'
        idempotency: not supported