API documentation · v2

Introduction (v2)

Legacy v2 of the Acme API. Maintained for existing integrations — new integrations should target v3.

This is the legacy v2 of the Acme API. It is maintained so existing integrations keep working, but new code should target v3 instead.

What’s missing in v2

v2 ships a smaller surface area than v3:

  • No colour field on widgets
  • No PATCH /widgets/{id} (update) endpoint
  • No DELETE /widgets/{id} endpoint
  • No /users/me endpoint

If you need any of these, migrate to v3.

Authentication

Identical to v3 — Bearer token in the Authorization header. See the v3 introduction for full details.