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

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 "Authentication: Bearer ..." \
  -d '{"state": "closed"}'