> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-transitions.md).

# /api/v1/transitions

Manage workflow **transitions** — rules that fire when objects are inserted, updated or deleted, gated on the object's tags, and run actions (set/unset tags, send email, call a webhook, change the owner, or invoke a plugin callback). This endpoint is the admin surface: list the defined transitions, replace them. The transitions themselves are evaluated implicitly during the object save pipeline, not through a separate endpoint.

Both operations require the `system.tagmanager` system right (a user holding `system.root` is always granted it). The endpoint takes no path, query, or header parameters; authentication uses the standard access token (see the API overview).

Differs from easydb 5: easydb 5 gated only the `POST`, and on the `system.rights_management` right; **fylr** gates both methods on `system.tagmanager`. easydb 5 returned `400` when the session was unauthenticated or lacked the right; **fylr** returns `401` (`UserRequired`) and `403` (`SystemRightRequired`) respectively.

### `GET /transitions` — List all defined transitions.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/transitions" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-c3d2ed00690a147053958a61f7d0920d721d2eca%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /transitions` — Replace the full set of transitions.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/transitions" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-c3d2ed00690a147053958a61f7d0920d721d2eca%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}