"PUT /rest/api/2/issue/{issueIdOrKey}" endpoint seems to ignore transition

[Corbin Hughes]

The documentation says that this endpoint should support specifying a transition, but the transition seems to be ignored. In particular, I'm running the equivalent of this:

curl -vv \
  -XPUT \
  --user 'username:password' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"update": {}, transition: {"id": "1"}}' \
  "https://our.internal.jira/rest/api/2/issue/JIRA-123?notifyUsers=false"

A 204 response is returned, and if I do something else in the edit (for example, add a comment or something), the other part will be performed. It just seems that no matter what I do the transition won't happen (I've made sure the ID is correct, and that no fields are required on the transition).

Is there a minimum version of JIRA for the transition functionality to work through this endpoint? Is it a cloud-hosted only functionality or something? I know that there's also a separate endpoint for transitioning, and that one works, but it doesn't support notifyUsers.

[Corbin Hughes]

Added the rest-api tag late, so bumping in hopes someone will see this :).