Docs

Update Transaction

PUT /events/{eventId}/transactions/{transactionId}

PUT/events/{eventId}/transactions/{transactionId}

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Event tokenx-Event-TokenOptionalRun **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually.

Updates an existing transaction. All fields are replaced — provide the full desired state. Account fields (debitAccount, creditAccount) are optional: pass null to keep the existing account, or provide a new account ID to reassign.

Updating a transaction automatically recalculates balances on any affected accounts.

Requires EventAccountingAdmin permission on the event.

Path Parameters

FieldTypeRequiredDescription
eventIdGuidRequiredThe ID of the event.
transactionIdGuidRequiredThe ID of the transaction to update.

Request Body

FieldTypeRequiredDescription
namestringRequiredThe transaction's display name.
dateDateTimeRequiredThe date of the transaction.
statestringRequiredTransaction state. One of: `Quoted`, `Committed`, `Paid`, `Excluded`.
debitAccountGuid?OptionalNew debit account ID. Pass `null` to keep the existing account.
creditAccountGuid?OptionalNew credit account ID. Pass `null` to keep the existing account.
quotedAmountintRequiredThe estimated amount, in cents. Must be ≥ 0.
invoicedAmountintRequiredThe invoiced amount, in cents. Must be ≥ 0.
quoteFileIdGuidRequiredFile ID for the quote document. Pass `00000000-0000-0000-0000-000000000000` to clear.
invoiceFileIdGuidRequiredFile ID for the invoice document. Pass `00000000-0000-0000-0000-000000000000` to clear.

Example Request (advance state to Committed)

{
  "name": "Venue Deposit",
  "date": "2026-03-15T00:00:00Z",
  "state": "Committed",
  "debitAccount": null,
  "creditAccount": null,
  "quotedAmount": 100000,
  "invoicedAmount": 95000,
  "quoteFileId": "00000000-0000-0000-0000-000000000000",
  "invoiceFileId": "file-guid-002"
}

Response

200 OK — No response body.

Error Codes

CodeHTTP StatusDescription
UNAUTHORIZED401Missing or invalid token, or caller lacks EventAccountingAdmin.
NOT_FOUND404Transaction, debit account, or credit account not found on this event.
BAD_REQUEST400Invalid state, negative amount, or missing required field.