S2 Dev · OpenAPI Overlay 1.0.0

API Evangelist enhancements for S2, the durable streams API

2 actions 2 updates update extends openapi/s2-dev-openapi-original.json

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

x-apievangelist-providerx-apievangelist-categoryx-apievangelist-agent-readyx-apievangelist-notes

Targets 2

$.info

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for S2, the durable streams API
  version: 1.0.0
extends: openapi/s2-dev-openapi-original.json
actions:
  - target: $.info
    update:
      x-apievangelist-provider: s2-dev
      x-apievangelist-category: streaming
      x-apievangelist-agent-ready: true
      x-apievangelist-notes: >-
        S2 is a durable, real-time stream store. Auth is a scoped bearer
        access token (capability model: op_groups + resource sets), not OAuth2.
        ensure_basin / ensure_stream (PUT) are idempotent upserts; appends use
        match_seq_num (optimistic) and fencing_token (pessimistic) for
        concurrency. Cursor pagination via has_more.
  - target: $.servers
    update:
      - url: https://a.s2.dev/v1
        description: Account / control-plane endpoint
      - url: https://{basin}.b.s2.dev/v1
        description: Basin-scoped data-plane endpoint
        variables:
          basin:
            default: my-basin
            description: Basin name