Update transaction status

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

Transitions a transaction between draft and posted status. Posting a transaction includes it in balance calculations and reports. Reverting to draft excludes it.

Reconciled transactions cannot be reverted to draft — unreconcile first using the reconcile endpoint.

Path parameters

id string required

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

Body parameters

status string required

New status. Cannot revert reconciled transactions to draft.

draftposted

Response

200 Transaction status updated.

Show response fields

status string

Error codes

400 Invalid ID, or cannot revert a reconciled transaction to draft.

404 Transaction not found.

Request PATCH /v1/transactions/{id}/status curl

curl -X PATCH https://api.speybooks.com/v1/transactions/txn_98/status \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "status": "posted" }'

Response 200

{
  "success": true,
  "data": {
    "status": "posted"
  }
}