API Reference

Update an approval section

put
https://stage-api.findity.com/api/v1/admin/organizations//approval/sections/

Updates an existing approval section. The type field is required in the body and must match the section's type. The organizationId path parameter supports both the Findity id and the partner-side externalId.

Path Params
string
required

Unique identifier of the organization. String in UUID without dashes (32-character hex string) if access is done via values from Findity system otherwise, id of external system can be used

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

Unique identifier of the approval section. String in UUID without dashes (32-character hex string).

Body Params

Request body for updating an existing approval section. Only the fields present in the body are updated.

string
enum
required

Type of the approval section. Must match the existing section's type and is used to validate the request.

Allowed:
boolean

Whether the section is active. When omitted the current value is preserved.

int32
≥ 0

Zero-based position of the section within the organization's list of approval sections. Changing sortOrder reorders sibling sections accordingly. When omitted the current value is preserved.

boolean

Whether expense reports should be sent to approvers who are not otherwise authorized on the section item. When omitted the current value is preserved.

integer | null
1 to 3

Number of sequential approvals required for expense reports evaluated against this section. Must be at least 1 and cannot exceed the value set on the main approval setup. When null or omitted the current value is preserved.

Responses

Updated about 5 hours ago

Did this page help you?
Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 5 hours ago

Did this page help you?