Delete Transaction
DELETE /api/v1/transactions/:id
Deletes a transaction permanently.
Warning: This action cannot be undone. The transaction will be permanently deleted.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Transaction ID |
Example Request
curl -X DELETE "https://statements.finopsbricks.com/api/v1/transactions/abc123xyz789" \
-H "api-key: fob_stm_xxxxxxxxxxxx" \
-H "api-secret: xxxxxxxxxxxxxxxx"
Response
Returns 204 No Content on success.
What Happens
When a transaction is deleted:
- The transaction is permanently removed from the database
- It will no longer appear in lists or reports
- The statement it came from is not affected
- This action cannot be undone
Bulk Delete
To delete multiple transactions, call this endpoint for each transaction ID. There is currently no bulk delete endpoint.
Errors
| Code | Description |
|---|---|
| 401 | Invalid or missing API credentials |
| 403 | API key lacks transactions:delete permission |
| 404 | Transaction not found |