API v1 (legacy — frozen)

v1 is the original Zapier-shaped API at app.sortd.com/api/v1. It is frozen — security and bug fixes only, no new endpoints — and stays at its current URL so existing integrations keep working.

Read the full v1 API reference v2 reference

Should I use v1 or v2?

	v1 (legacy)	v2 (current)
Host	app.sortd.com/api/v1	api.sortd.com/v2
Auth	x-access-token JWT (≈20 min)	Bearer API key / OAuth 2.1
IDs	raw Mongo ids	opaque, prefixed (tsk_, brd_…)
Envelope	raw JSON	{ data, meta }
Pagination / idempotency / scopes	—	yes
Webhooks	7 unsigned triggers	signed, retried, replayable

New integrations should use v2. A migration guide and a v1→v2 mapping ship with the v2 launch.