Transition Task Instance

Advance or revert a task instance to a new state in its configured workflow. Requires READ, ADMIN, or MANAGE_TO_DO permissions.

Parameters

name * are required parameters	data type	description
instanceId*	string	The unique identifier of the task instance
body.state*	string	The target state to transition to
body.data	object	Any data to save during the transition
body.comment	object	Comment to save and include in notifications

Return Value

The updated task instance with the new state applied.

Examples

bash

curl -X PUT "https://app.wombat.software/api/{targetPath}/task/:instanceId/transition" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ..." \
  -d '{"state": "closed", "comment": {"type": "doc", "content": []}}'