Tasks
Dismiss Task
Dismiss a task — transition any task to DISMISSED by applying its unique
dismissal action. For approval tasks this is the “deny / reject” primitive; for
non-approval tasks it cancels the task without performing its work.
Common uses:
- Deny an access request.
- Cancel a non-approval task (e.g. dismiss an error task once the underlying issue is
handled out-of-band). Tasks with multiple possible dismissal actions should use
POST /tasks/{task_id}/perform-actioninstead.
Resolves the unique action on the task that transitions it to DISMISSED and applies it
on behalf of the caller. The caller must be an assignee of the task (or a domain admin).
There is no request body.
Responses:
204 No Content— task dismissed.403 Forbidden— caller is not authorized to act on the task.409 Conflict— task is already in the requested status.404 Not Found— task does not exist in this domain, or the Tasks API is not enabled.
To approve instead of deny, use POST /tasks/{task_id}/complete.
POST
Dismiss Task