---
title: "Update settlement approval request"
method: PUT
path: "/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/approval-requests/{approvalRequestId}"
tags: ["Settlement Approvals"]
---

# Update settlement approval request

`PUT /api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/approval-requests/{approvalRequestId}`

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/clearing/v1/enterprise/{enterpriseId}/account/{accountId}/approval-requests/{approvalRequestId}`
- Auth: none declared. Required headers: `user-id`, `user-agent`, `x-forwarded-for`, `token-scope`

Update a settlement approval request.

Use only with delivery versus payment (DVP) settlements.

**Requires access token scope:** `wallet_spend_all`

## Path parameters

- `enterpriseId` string, required
- `accountId` string, required
- `approvalRequestId` string, required

## Headers

- `user-id` string, required
- `user-agent` string, required
- `x-forwarded-for` string, required
- `token-scope` string, required
- `origin` string

## Request body

- object
  - `status` 'acknowledged' | 'canceled' | 'rejected', required

## Response `200`

OK

- ApprovalRequestResponse
  - `id` string, required
  - `accountId` string, required
  - `status` 'acknowledged' | 'canceled' | 'rejected' | 'approved' | 'pending' | 'failed' | 'overdue' | 'expired' | 'initialized' | 'signed' | 'signing' | 'pending-acknowledgement', required
  - `payload` string, required
  - `signature` string
  - `policyDetailId` string
  - `policyDetail` object
    - `id` string, required
    - `resolutionTime` string, date-time, required
    - `resolvedBy` string[], required
  - `signedAt` string, date-time
  - `signedBy` string
  - `approvedAt` string, date-time
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `settlementId` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) - [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/7b339264eaee?raw)