API Reference

Build directly on the API.

Most customers, and every AI agent, talk to TrackChanges over HTTP. The CLI is a thin wrapper around this same API.

Interactive API explorer
Full route list, request/response schemas, and a live "try it out" console.
Open Swagger UI →

Base URL

https://api.trackchanges.io

Authentication

Every request (except signup, login, and health) requires an API key in the Authorization header.

Authorization: Bearer tch_live_...

Keys are scoped to a workspace, or account-wide if created without one. Four roles apply in order of increasing access: readonly, member, admin, owner.

Common routes

A quick-reference sample. The Swagger UI above has the complete, always-current list.

POST/subscribemember
GET/sourcesreadonly
GET/sources/{ref}/diffsreadonly
GET/diffs/{diff_uuid}readonly
POST/sources/{ref}/webhooksadmin
GET/auditowner

Example: fetch the latest diff

# list recent diffs for a source
curl https://api.trackchanges.io/sources/stripe-api/diffs \
  -H "Authorization: Bearer $API_KEY"