---
title: "Delete a buy instruction"
method: DELETE
path: "/v1/stablecoin/fiat-instructions/{id}"
tags: ["Fiat instructions"]
---

# Delete a buy instruction

`DELETE /v1/stablecoin/fiat-instructions/{id}`

## Request

- Base URL: `https://api.ripple.com`
- URL: `https://api.ripple.com/v1/stablecoin/fiat-instructions/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.ripple.com/v2/oauth/token` scopes: `rlusd_customers:write`
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-mint-api/docs/v1/stablecoin/fiat-instructions/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Retires a buy instruction you no longer intend to use, so a fiat payment arriving later with
its memo can never mint against it. Because instructions never expire, this is the only way
to retire an unused one - an abandoned instruction left alone stays `UNUSED` and claimable
indefinitely.

Deletion is permanent and there is no un-delete: create a new instruction with a new id,
which gets a new memo. Transactions already produced from the instruction are unaffected and
keep their `fiatInstructionId` and `memo`.

Only your own `UNUSED` buy instructions can be deleted. A redemption (`FIAT`) instruction is
reported as `404`, since this operation only addresses your `CRYPTO` instructions.

## Path parameters

- `id` string, uuid, required

## Response `200`

Instruction deleted. The body is empty, and a subsequent `GET` or `DELETE` on the id
returns `404 FIAT_INSTRUCTION_NOT_FOUND`.

## Other responses

- `401`: Missing or expired access token
- `403`: The caller is not entitled to the operation - either the access token lacks the scope the operation requires, or the tenant is not entitled to the API at all (`FORBIDDEN`).
- `404`: Unknown id, another customer's instruction, an already-deleted instruction, or a redemption (`FIAT`) instruction (`FIAT_INSTRUCTION_NOT_FOUND`).
- `409`: The instruction is `USED` or `CANCELED` (`FIAT_INSTRUCTION_INVALID_STATUS_TRANSITION`) - a claimed memo cannot be retired.
- `500`: Unexpected server error

## Changes

- **2026-09-18** `6db752579872`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ripple/apis/ripple-mint-api/changes/v1/stablecoin/fiat-instructions/:id/delete.md)

---

[API](https://skmtc.dev/ripple/apis/ripple-mint-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-mint-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-mint-api/revisions/6db752579872?raw)