SPOTIO · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Spotio 2.0 Routes V2 API

2 actions 2 updates update extends openapi/spotio-routesv2-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for SPOTIO's API. It is a proposal applied on top of the contract, not a document SPOTIO publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-capabilityx-apievangelist-operationsx-apievangelist-contract-sourcex-apievangelist-docsx-apievangelist-authx-apievangelist-paginationx-apievangelist-error-envelope

Targets 2

$.info

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Spotio 2.0 Routes V2 API
  version: 1.0.0
extends: openapi/spotio-routesv2-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/_original/spotio-swagger.json
actions:
- target: $.info
  update:
    x-apievangelist-provider: spotio
    x-apievangelist-capability: RoutesV2
    x-apievangelist-operations: 8
    x-apievangelist-contract-source: https://api.stoplight.io/projects/cHJqOjIzMTU4MQ/branches/main/export/spotio-swagger.json
    x-apievangelist-docs: https://developer.spotio2.com/docs/spotio2/a4cpj8d1knctg-quickstart-for-the-spotio-api
    x-apievangelist-auth: Bearer JWT minted at POST /api/users/apitoken with clientId + secret; tokens expire after
      30 days
    x-apievangelist-pagination: cursor via scrollId; repeat until scrollId is null. perPage overrides page size
      where declared.
    x-apievangelist-error-envelope: '{"errors": {"<field>": "<message>"}} - not RFC 9457'
    x-apievangelist-idempotency: none published
    x-apievangelist-rate-limits: none published; 429 declared on no operation
    x-apievangelist-mcp: https://app.spotio2.com/mcp (SPOTIO-MCP-KEY)
    x-apievangelist-known-defect: source document declares no operationId on any operation
- target: $.servers
  update:
  - url: https://api.spotio2.com
    description: Production
  - url: https://app-test.spotio2.com
    description: Test
  - url: https://stoplight.io/mocks/spotio/spotio2/264959918
    description: Prism mock published by SPOTIO Stoplight project - any Authorization bearer value is accepted