Delete a draft transaction

DELETE https://app.speybooks.com/api/v1/transactions/{id}

Permanently deletes a draft transaction and its lines. Only transactions with status: "draft" and sourceType: "manual" can be deleted.

System-generated transactions (from invoices or bank imports) cannot be deleted directly — delete or cancel the source document instead. This preserves the audit trail.

Path parameters

id string required

Transaction ID (e.g. txn_42). Must use the transaction prefix.

Response

200 Transaction and all journal lines permanently deleted.

Show response fields

deleted boolean

Error codes

400 Transaction is not in draft status, or is system-generated (delete the source document instead).

404 Transaction not found.

Request DELETE /v1/transactions/{id} curl

curl -X DELETE https://api.speybooks.com/v1/transactions/txn_99 \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "deleted": true
  }
}