Wallets

Cancel wallet approval request

Cancels a pending wallet operation approval request. The requester may cancel its own request; otherwise the resolver must be an active member of the assigned approval group, or an organization/API admin when no group is assigned. A user and the API keys they created are treated as the same requester.

post/v1/wallets/approval-requests/{approvalRequestId}/cancel

Path parameters

approvalRequestIdstring required

Approval request ID.

Example:appr_example

Approval request ID.

Headers

x-project-idstring

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Response

Wallet approval request

Example response

{
  "data": {
    "approvalRequest": {
      "id": "appr_example",
      "projectId": "prj_example",
      "status": "pending",
      "provider": "fireblocks",
      "providerReference": "fb_tx_123",
      "expiresAt": "2025-01-01T00:00:00.000Z",
      "resolvedAt": "2025-01-01T00:00:00.000Z",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-01T00:00:00.000Z",
      "wallet": {
        "walletId": "privy_wallet_123",
        "publicKey": "So11111111111111111111111111111111111111112"
      },
      "operation": {
        "walletId": "privy_wallet_123",
        "source": "api",
        "operationFamily": "payment",
        "operationType": "payment_transfer_execute",
        "status": "pending_approval",
        "executionStartedAt": "2025-01-01T00:00:00.000Z",
        "executionCompletedAt": "2025-01-01T00:00:00.000Z",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-01T00:00:00.000Z"
      },
      "policyEvaluation": {
        "decision": "approval_required",
        "reasonCode": "wallet_policy_match",
        "requiresApproval": true,
        "evaluatedAt": "2025-01-01T00:00:00.000Z"
      }
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes

Changed in 2 of the 10 revisions of this API.67

Aug 19, 2026f138f2b586637See the full diff
- ○
  removed the issuance enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the payment enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the program enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the provider_admin enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ramp enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the raw_sign enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the transfer enum value from the data/approvalRequest/operation/operationFamily response property for the response status 200
  response-property-enum-value-removed
Aug 15, 20263e302bba53866See the full diff
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 403
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 409
  response-property-enum-value-added
- ●
  added the new SERVICE_UNAVAILABLE enum value to the error/code response property for the response status 500
  response-property-enum-value-added

Full history