The public API now has two versions. v1 is complete and stable: its routes, permissions, request defaults, response fields and OpenAPI schema are fixed and will stay that way. Integrations built on v1 can keep running without changes.

v2 is available now at /v2, with the same endpoints and behavior as v1 to start, and is where new endpoints and richer responses will be added from here on. Existing API keys, scopes, expiry and revocation work across both versions, and an integration picks the version in the URL. Build on v2 when you want the newest capabilities, and stay on v1 when you want a contract that will not move.
Both references and their downloadable specs are on api-docs.pactly.com.
