Update transaction status

PATCHhttps://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

idstringrequired

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

Body parameters

statusstringrequired

New status. Cannot revert reconciled transactions to draft.

draftposted

Response

200Transaction status updated.

Show response fields

statusstring

Error codes

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

404Transaction not found.

RequestPATCH/v1/transactions/{id}/statuscurl

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" }'

Response200

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