---
id: approval-deny-create
title: "Deny a request"
description: "Denies a request by ID."
sidebar_label: "Deny a request"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/api/approval
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Deny a request"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/approval/{id}/deny"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Denies a request by ID. 

:::note
This endpoint is executed according to the URL you received in the approval notification.
:::


<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the approval.","example":1234},{"in":"query","name":"token","required":true,"schema":{"type":"string"},"description":"The authentication token provided in the approval notification.","example":"your-authentication-token"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","required":["reviewer"],"properties":{"reviewer":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string","description":"The name of the approver.","example":"Alex Manager"},"email":{"type":"string","description":"The email of the approver.","example":"alex.mgr@crypto-inc.com"},"nullplatform_user_id":{"type":"integer","description":"The nullplatform ID of the approver (optional)."}},"example":{"name":"Alex Manager","email":"alex.mgr@crypto-inc.com","nullplatform_user_id":null},"description":"The person or system that denied the request."},"message":{"type":"string","description":"An optional message explaining the approver's decision.","example":"Denied because the request falls outside the deployment window."},"details":{"type":"object","description":"Additional structured metadata related to the approver's decision.","example":{"deployment_window":"Mon-Fri ; 9 AM to 5 PM"}}},"example":{"reviewer":{"name":"Alex Manager","email":"alex.mgr@crypto-inc.com","nullplatform_user_id":null},"message":"Denied because it's outside of the deployment window.","details":{"deployment_window":"Mon-Fri ; 9 AM to 5 PM"}},"title":"approval_replyDeny"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"required":["success"],"properties":{"success":{"type":"boolean","description":"Indicates whether the operation was successful.","example":true}}}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>