/v1/client/approvals/{approval_id}/decisionAuthAnswer an approval request
Approve or reject, with an optional reason (required when the type says so). The first answer of any approver decides; the requester gets the signed `approval.resolved` webhook. Answering again, or after the request expired, is a 409.
Path parameters
approval_id*string · uuidId of the approval.
Request body
decision*object`approve` or `reject`.
reasonstringWhy (required when the type says so).
Response · 200 Decided.
id*string · uuidThe approval request id.
type*stringThe notification type key.
Example: "deploy.approval"
status*object`pending` until someone answers; then `approved` or `rejected`; `expired` (or the type's timeout outcome) when nobody answered in time; `cancelled` when the requester withdrew it.
title*stringThe question.
body*stringThe details.
requester*objectWho asked.
approvers*arrayApprover external ids (null entries for erased recipients are dropped).
metadata*objectYour metadata, as sent.
expires_at*string · date-timeWhen it times out.
decided_by*stringWho answered (external id); null while pending, on timeout or cancel.
reason*stringThe approver's reason, if they gave one.
decided_via*objectWhere the answer came from: `inbox` (in-app buttons or `<NotifyApproval/>`), `hosted_page` (the link in an email or push), `api` (your backend), `timeout`.
decided_at*string · date-timeWhen it was answered, expired or cancelled.
notification_id*string · uuidThe notification that carried it (see the message log for every channel's delivery).
created_at*string · date-timeCreated.
Example
Request
POST https://api.notify.productcraft.co/v1/client/approvals/{approval_id}/decision
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"decision": {},
"reason": "string"
}Response
{
"id": "00000000-0000-0000-0000-000000000000",
"type": "deploy.approval",
"status": {},
"title": "string",
"body": "string",
"requester": {},
"approvers": [
"string"
],
"metadata": {},
"expires_at": "2026-01-01T00:00:00.000Z",
"decided_by": "string",
"reason": "string",
"decided_via": {},
"decided_at": "2026-01-01T00:00:00.000Z",
"notification_id": "00000000-0000-0000-0000-000000000000",
"created_at": "2026-01-01T00:00:00.000Z"
}