Skip to main content
  • Base URL: https://api.refmatter.com
  • Versioning: all product endpoints live under /v1. Additive changes ship without a version bump; breaking changes get /v2.
  • Authentication: Authorization: Bearer <workspace API key> for machines, session cookies for people. See Authentication.
  • Content type: JSON in, JSON out. Timestamps are RFC 3339 UTC. Ids are UUIDs.
  • Idempotency: POST /v1/ingestions requires an Idempotency-Key header.
  • Errors: one envelope with a stable code; see Errors.
  • Contract: the machine-readable source of truth is GET https://api.refmatter.com/openapi.json. Every operation carries x-implementation-status; only implemented operations are availability claims.