State.md

@@ -36,4 +36,8 @@ You may join instance_state on your base entity to get it's details or filter by
    "conds" : {"instance_state.name" : {"-ilike":"a%"}},
    "attrs" : {"join":"instance_state"}
 }
-```
+```
\ No newline at end of file
+
+# available transitions
+
+To find out, which transitions are allowed for the state (and user) the instance is in, use the [Instance Transition List Endpoint](https://git.ironapi.com/ironapi/api/-/wikis/api/Transitions#instance-transitions-list-datamoduleentityinstance_idtransitions).
\ No newline at end of file