/bff/expense/record-add

Append a record (state change / comment / attachment) to an expense

ExpensepostBffExpenseRecord-add

Parameters

JSON body

Request body

application/json

The record must contribute something: at least one of (non-empty message, status change, attachment). A record with none of those is rejected with an application error before the DB CHECK fires.

externalIdstringRequired

Length: 24–24

messagestring | nullOptional

Free-form comment. Empty allowed when the record carries a status change or an attachment.

One of 2:

Variant 1

string

Length: 0–5000

Variant 2

null

New status. Omit or set null for pure comment / attachment records. Any of new / approved / in_progress / review / done / rejected.

One of 2:

Variant 1

Variant 2

null

blobTokenstring | nullOptional

Blob token from a prior /file-upload. One attachment per record — attach many files by writing many records.

One of 2:

Variant 1

string

Variant 2

null

Response schema

1 status code documented

200Success

successbooleanRequired

Default: true

recordIdnumberRequired

Response example

application/json

{
  "success": true,
  "recordId": 0
}

Request example

POST /bff/expense/record-add

post

curl -X POST "https://api.bizkithub.com/bff/expense/record-add" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "externalId": "example_externalId"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key