Permutive · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Permutive Events API

1 action 1 update update extends openapi/permutive-events-api-openapi.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

x-apievangelist-sourcex-apievangelist-provenancex-apievangelist-reviewx-apievangelist-productx-apievangelist-agent-cardx-apievangelist-mcpx-apievangelist-notex-apievangelist-observed-gaps

Targets 1

$.info

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Permutive Events API
  version: 1.0.0
extends: openapi/permutive-events-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-source: https://docs.permutive.com/api/introduction
    x-apievangelist-provenance: Permutive-published OpenAPI, recovered 2026-08-13 from the Permutive documentation
      MCP server virtual filesystem (/openapi/api/events/openapi.json). Not served over HTTP at any public
      URL.
    x-apievangelist-review: https://apis.io/permutive
    x-apievangelist-product: Connectivity
    x-apievangelist-agent-card: https://docs.permutive.com/.well-known/agent-card.json
    x-apievangelist-mcp: https://docs.permutive.com/mcp
    x-apievangelist-note: Event bodies are validated against the event schema defined in the workspace;
      that schema is not part of this OpenAPI.
    x-apievangelist-observed-gaps:
    - No idempotency key — a retried POST /events creates a duplicate event, which skews cohort frequency
      conditions.
    - No 429 declared.
    x-apievangelist-artifacts:
      authentication: authentication/permutive-authentication.yml
      conventions: conventions/permutive-conventions.yml
      errors: errors/permutive-problem-types.yml
      lifecycle: lifecycle/permutive-lifecycle.yml
      rate_limits: rate-limits/permutive-rate-limits.yml
      data_model: data-model/permutive-data-model.yml