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-action instead.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the task.

Responses
204

Successful Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json