Cast approval vote
Submit your approval or rejection vote for a pending transaction that requires multi-party approval. Only users in the designated approver list can cast votes.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
approvalRequestId | UUID | Yes | Approval request identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
vote | enum | Yes | Vote decision: APPROVED or REJECTED |
comment | string | No | Optional comment explaining the vote decision |
Approval Workflow
- Eligibility Check — Verify voter is in approver list
- Duplicate Check — Ensure voter hasn't already voted
- Vote Recording — Record vote with timestamp
- Threshold Check — Check if required approvals reached
- Status Update — Update transaction status if threshold met
Response Fields
| Field | Type | Description |
|---|---|---|
vote | enum | Vote that was cast (APPROVED or REJECTED) |
finalStatus | enum | Final status of approval request (nullable if threshold not yet met) |
message | string | Human-readable message about the vote result |
Use Cases
- Approve high-value transactions
- Reject suspicious or unauthorized transactions
- Participate in multi-sig workflows
- Implement separation of duties
- Build approval dashboards and notifications
Required Permission
transactions:approve
Cast approval vote
Submit your approval or rejection vote for a pending transaction that requires multi-party approval. Only users in the designated approver list can cast votes.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
approvalRequestId | UUID | Yes | Approval request identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
vote | enum | Yes | Vote decision: APPROVED or REJECTED |
comment | string | No | Optional comment explaining the vote decision |
Approval Workflow
- Eligibility Check — Verify voter is in approver list
- Duplicate Check — Ensure voter hasn't already voted
- Vote Recording — Record vote with timestamp
- Threshold Check — Check if required approvals reached
- Status Update — Update transaction status if threshold met
Response Fields
| Field | Type | Description |
|---|---|---|
vote | enum | Vote that was cast (APPROVED or REJECTED) |
finalStatus | enum | Final status of approval request (nullable if threshold not yet met) |
message | string | Human-readable message about the vote result |
Use Cases
- Approve high-value transactions
- Reject suspicious or unauthorized transactions
- Participate in multi-sig workflows
- Implement separation of duties
- Build approval dashboards and notifications
Required Permission
transactions:approve