Skip to main content
DELETE
/
beneficiaries
/
{beneficiaryId}
Delete Beneficiary
curl --request DELETE \
  --url https://api.rolla.xyz/api/v1/external/beneficiaries/{beneficiaryId} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Beneficiary deleted successfully"
}
Delete a saved beneficiary. This action cannot be undone.

Example Request

curl -X DELETE "https://api.rolla.xyz/api/v1/external/beneficiaries/c3d4e5f6-a7b8-9012-cdef-123456789012" \
  -H "X-API-Key: your_api_key_here"

Example Response

{
  "success": true,
  "message": "Beneficiary deleted successfully"
}
Deleting a beneficiary is permanent. Any future withdrawals to this recipient will require creating a new beneficiary or using inline beneficiary details.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Path Parameters

beneficiaryId
string<uuid>
required

Beneficiary UUID

Response

Beneficiary deleted successfully

success
boolean
Example:

true

message
string
Example:

"Beneficiary deleted successfully"