Send an expense report

put

https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/reports/{reportId}/send

Sends a single expense report to its recipient. Validation problems do not refuse the send, they come back as warnings with a 200, which is how this endpoint has always behaved.
This is its own path rather than an action on the report resource because it carries its own permission: it is available to roles that may send a report without being allowed to edit it.

Path Params

organizationId

string

required

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

The unique identifier of the organization. String, UUID format (32-character hexadecimal). Required.

reportId

string

required

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

The id of the expense report to retrieve

Query Params

lang

string

Locale the warnings in the response are translated to. String, language variant such as sv_SE. Optional, the request locale is used when omitted.

Body Params

Request body for sending a single expense report.

skipAttestation

boolean

Set to true to send the report without attestation. Boolean. Optional, defaults to false.

action

string

enum

Which flavour of send this is. String, enum. Accepted values: resend, resend-with-approval, resend-without-approval, return-report-to-user, forward-without-approval. Optional, omit it for a plain send.

Allowed:

messageText

string

Message to include with the report, used by the resend and return flavours. String, no maximum length is enforced. Optional.

Responses

200The report was sent, possibly with validation warnings

400The request body could not be parsed

403The caller may not edit this organization

404The organization or the expense report was not found