API Reference

Update an approver on an approval section item

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

Updates an existing approver on an approval section item. The body must contain the approver's id (which must match the approverId in the URL), the sectionItemId the approver belongs to, and the target level. 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).

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

Unique identifier of the approver assigned to an approval section item. String in UUID without dashes (32-character hex string).

Body Params

Request body for updating an existing approver on a section item. The id field must match an existing approver on the section item. Only the fields present in the body are updated.

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

Findity identifier of the approver being updated (as returned from GET or POST).

string
required
length ≤ 255

Identifier of the approval section item this approver belongs to. For DEPARTMENT sections this is the organizational unit id; for DIMENSION sections this is the custom dimension list value id.

integer
required
≥ 0

Zero-based sequential approval level at which this approver acts. Must be greater than or equal to 0; approvers are processed from lowest (0) to highest level.

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

Findity identifier of the person acting as approver. Provide either personId or personExternalId.

string
length ≤ 255

External source identifier of the person acting as approver. Ignored if personId is also provided.

double | null
≥ 0

Maximum expense report amount this approver is authorized to approve, expressed in the organization's base currency. Send null to clear the limit.

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?