Inferrex

/ developers · api changelog

API changelog.

Every change to the customer-facing Inferrex API, dated and reverse-chronological. The same record is published machine-readable at /api-changelog.json.

View JSONAPI reference

The contract is versioned under /v1. Breaking changes ship a new version with a migration window: a deprecated operation is flagged deprecated: true in the OpenAPI spec and returns a Deprecation header (plus Sunset and a Link rel="successor-version"). Subscribe to the machine-readable changelog JSON to track changes programmatically.

2026-06-18

  • Added — Outbound webhooks now cover every customer-facing resource — 47 event types spanning workflows, alert rules, golden-record proposals, governance/retention/approval policies, circuit breakers, environments, teams, and API-key scopes. Register an endpoint at POST /v1/webhooks/subscriptions, filter by event type, and verify the X-Inferrex-Signature HMAC; X-Inferrex-Event-Id is stable across redeliveries. The full catalogue ships in the OpenAPI x-webhooks extension.

2026-06-10

  • Added — Idempotency-Key on every unsafe request (POST/PUT/PATCH/DELETE) — the first response is cached for 24h and replayed verbatim on retry (a replay carries Idempotent-Replayed: true), so an agent can retry safely.
  • Added — Keyset cursor pagination on high-volume list endpoints (cursor + nextCursor + hasMore) alongside offset pagination — stable under inserts, no deep-offset cost.

2026-06-03

  • Added — Per-key / per-tier token-bucket rate limits with X-RateLimit-Limit / -Remaining / -Reset headers (plus the draft RateLimit-* equivalents) and Retry-After on 429 — an agent behind one NAT egress gets its own ceiling.
  • Added — Granular API-key scopes (:); each operation declares the scope it needs in its security, and the full catalogue is in the OpenAPI x-api-scopes extension.
  • Changed — Every error response now carries { error, message, retryable, docs_url } — retryable tells an agent whether the same request could succeed on retry, and docs_url links the error code so it can self-correct without a human.

2026-05-26 · v1

  • Added — Inferrex API v1 — a REST API at https://api.inferrex.com, a typed TypeScript SDK (@inferrex/sdk), and an MCP server (@inferrex/mcp), all generated from one source so the contract never drifts. The machine-readable OpenAPI 3.0.3 spec is published credential-free at /openapi.json, alongside /v1/pricing and /.well-known/llms.txt.