---
id: approval-approve-create
title: "Approve a request"
description: "Approves a request using its ID."
sidebar_label: "Approve a request"
hide_title: true
hide_table_of_contents: true
api: eJzdWNtuGzcQ/RWCL02Atawk9ss+VbkUddGihiOjASzBGJEjLRMuuSG5thRh/70YcldaXeI4DdLbi7JmeDlzZs7hZc0leuFUFZQ1POejqnL2Dj0D5vBjjT6w2iuzYCp4dvF6wCZmYvI8NzbgxDA2LpRnaGRllQmMvpco6oCSgRDWSRoaLAsFsuurX9nK1syhQHWHkikT2yEuCZoZG9RcCSAog7jKxPCMB1h4nt+00EDzacZthS72u5A8590Mt+kDc+EQAvKMexS1U2HF85s1nyE4dKM6FDy/mTbTjFfgoMSAzscOihioIBQ84wZK5DlXkmYRBZbA8zUPqyq2moALdLzJOLGkHEqeB1djtkfnuEB28ZrZ+U6kA55xXEJZaeT5s+cvzpqsXfxjjW61XT3YD0gU7C9yAMgHp8yC8ByuD3Uo0ISWWBbnZAREyS8loY+Tr2ztTnYnO0kAicq2Wl5auSJcwpqAJtAnVJVu+5++9wRrfRiAnb1HEXZCveEO7xTeo6OMV45yHhR6GrX5ny/MEHnMOJag9OEsieV9Eo9xSD13s4hul52RxiX7DQy0dZGWfNTksevDs4PG5aBcuB+FW1XBnigjBsKWtJCpta40hLl15W3t0d0qeaRUj0bVG3pQpujYExt7g3464E3Tw9NRtxv1JujPwv0cWmo9WrsVOm8Ns475lQ9YslBA6ADKiLYtvAFxUaL3sHhETkeGdbGxdhDDZaVBmehYPRZ+8EyiUP5AD6MOhayRPA5LdAs0YsUkVtquSjSBtcVI336Q9BlAaX+scPcgSqlahD64WoTaoWQlBpAQyJ01kM225noU7V7O+qL5Lvnb0P9XuOlTQ8CDCqn0O3N3WOlVOzFvGuqzPOnjobjUwliHySejO/vKGp/k/nw4pH8Oq2yzm7B78MzXQqD38zr69KONbNda2kl6aZ5ZqxHMQZ4vjKRJ0bP7AkOBLubzIUiblMYgm0TF2bt3h8G90oqIRuesYxsuuqQocwda0RZQ1YE0Viof9/rttvhVDDxkxD5AqP0rK6MdEx6+rZcDY+71/rKT/TweX7I0ggkryREqh552qVbKvkJBmxoTfT6e4GAxyNjZcEg/z+jnBf2cPd0h+Ww4bIgE+RhbYSWIQhk8cQgSZhrbtSKu6F2U6oV16hP6hA0dWe0clK4d7jrMDORta29xS4m0PQLEzCmcZ6yoSzBbJL1endMncDRdx8aEvwTJrtKiE04N14Y2/QhZTvguOf3eX2fAW3drZc9gZuuwhbW7znjr9FERJWiSPEoW2TUBlImnmVTS/QruFHJ+TCFvE/37ClFJlFRAYJjyvkZm00lpdHnBvJL4P5OG7xPRFsM5SeN8+Jx+Xuwm/vyfUwUF6wzo29TpNlH2t+njol2etaXzhvokpVCLEsiuDdyB0jTrgWCODv+u0hkZVhtcVijovJBCskLUzqEcsEuN4JEFt2KwAGUYHStcp5p4gAho6DyR7kgfcMXz/Y0343egazzYgOliUGIoLN3SKuup9OP9Kuen3b5+ulayaf9KVzbiJS1WOzqNFCFUPj89hUoN+sumE/B0e8t7S3pLMunf9TaE0kTddS76a+zEs/bjJ+tKCDznv/wxjmcn0vHV9l7z5r96lFJmbgkp8Zpq6NlgOBjy7SFrc7duspinEkw/tARh+yawX5O9+96/8gUhpT/gMpzGMz6FGWtr3ZbjzeaYyTOex0t/V5HTjBdUufkNX69n4PHa6aah5nRZpzqVypPYJc/noP3+K0CfnSdXrfM/Zd9+Nz8aVxJo93LQ6pJHndyBU4Tz2zAff884iqVtBLPqQ+kwKsmbaZPxAkGSlDbu8iotfTKm4duBB1ssPZukESMhsAoP9u1b0eXvb8ck+/axoozbGHdwT1sz3CeQ6YKYnhuobc01mEWdVJnmJHHBrsfseUqM6igN63XqMaZMNQ3fzVwzbZrmT/PD3pk=
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={"Approve a request"}
>
</Heading>

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



Approves a request using its 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 approved the request."},"message":{"type":"string","description":"An optional message explaining the approver's decision.","example":"Approved due to emergency deployment requirements."},"details":{"type":"object","description":"Additional structured metadata related to the approver's decision."}},"example":{"reviewer":{"name":"Alex Manager","email":"alex.mgr@crypto-inc.com","nullplatform_user_id":null},"message":"Approved due to emergency deployment requirements.","details":{}},"title":"approval_replyApprove"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"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>