Unassign an approval task
POST/approvals/tasks/:id/unassign
Releases a pending task from its current approver, clearing approver_code. Self-unassign only: the caller must be the task's current approver. Group-routed tasks return to their tag pool; directly routed tasks return to the original approver's personal unassigned queue.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Task unassigned successfully
Bad request - missing parameters
Unauthorized - invalid or missing token
Forbidden - request denied by authorization, or blocked by the API firewall
Task not found, or not assigned to the caller
Conflict - task already completed or not actionable
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Retry-After
Delay in seconds a client must wait before retrying the request
Internal server error