Permutive · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Permutive Cohorts API

1 action 1 update update extends openapi/permutive-cohorts-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

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist enhancements for Permutive Cohorts API
  version: 1.0.0
extends: openapi/permutive-cohorts-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/cohorts/openapi.json). Not served over HTTP at any public
      URL.
    x-apievangelist-review: https://apis.io/permutive
    x-apievangelist-product: Signals
    x-apievangelist-agent-card: https://docs.permutive.com/.well-known/agent-card.json
    x-apievangelist-mcp: https://docs.permutive.com/mcp
    x-apievangelist-note: Cohort read paths are also reachable as agent tools on Permutive's invitation-only
      MCP server (list_cohorts, get_cohort_detail, search_cohorts). See mcp/permutive-tool-crosswalk.yml.
    x-apievangelist-observed-gaps:
    - No pagination on GET /v2/cohorts — the full cohort set is returned in one response.
    - No 429 declared, although per-workspace rate limits exist.
    - No idempotency key on POST /v2/cohorts.
    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