Update expense report

put

https://stage-api.findity.com/api/v1/expense/expensereports/{expenseReportId}

Updates an expense report owned by the calling user, or transitions its lifecycle.

Path Params

expenseReportId

string

required

^[0-9a-fA-F]{32}$

Id of the expense report.

Query Params

action

string

enum

Lifecycle transition to apply. When set, the request body is ignored: send submits the report for approval; retract recalls a previously-sent report.

Allowed:

forceSave

boolean

When true, saves the report even if non-blocking validation warnings exist; validation errors still abort. Defaults to false.

Body Params

comment

string

Free-text comment that travels with the report through approval and accounting integration.

emailRecipients

string

Recipients notified when the report is sent in. Comma-separated email addresses, stored as a free-text field.

expenseRecords

array of objects

Expense records to attach to the report. Each item is the id of an existing expense record owned by the caller.

expenseRecords

name

string

Display name of the report.

organizationId

string

^[0-9a-fA-F]{32}$

Organization that owns the report. Required on create; cannot be changed on update.

reportNumber

string

User-supplied report number. The server auto-generates one if omitted.

customFields

array of objects

Custom field values for the report. Each entry pairs a custom field definition with a value.

customFields

Responses

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Error

403Error

404Not found