---
title: "POST Reject a task review"
description: "Reject a task that is in review. Only the assigned approver can reject. Reverts status to the previous status and creates an audit comment."
last_updated: "2026-05-06T07:33:54.454291+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/tasks/taskscontroller-rejecttask"
---

<APIEndpoint
  method={"POST"}
  path={"/v1/tasks/:taskId/reject"}
  summary={"Reject a task review"}
  description={"Reject a task that is in review. Only the assigned approver can reject. Reverts status to the previous status and creates an audit comment."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"X-Organization-Id","in":"header","required":false,"description":"Organization ID (required for session auth, optional for API key auth)","schema":{"type":"string"}},{"name":"taskId","in":"path","required":true,"description":"Unique task identifier","schema":{"type":"string"}}]} />

## Responses

<APIResponse
  statusCode={"200"}
  description={"Task rejected successfully"}
/>

<APIResponse
  statusCode={"400"}
  description={"Task is not in review"}
/>

<APIResponse
  statusCode={"403"}
  description={"Not the assigned approver"}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/v1/tasks/:taskId/reject"}
  parameters={[{"name":"X-Organization-Id","in":"header","required":false,"description":"Organization ID (required for session auth, optional for API key auth)","schema":{"type":"string"}},{"name":"taskId","in":"path","required":true,"description":"Unique task identifier","schema":{"type":"string"}}]}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.