API Reference

Add an approver to an approval section item

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

Creates a new approver on a specific approval section item (an organizational unit for DEPARTMENT sections, a custom dimension value for DIMENSION sections). Identify the person by either personId or personExternalId. The request must not include an id. 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 creating a new approver on a section item. Identify the person by either personId or personExternalId — when both are present personId takes precedence.

string
required
length ≤ 255

Identifier of the approval section item this approver is being added to. For DEPARTMENT sections this is the organizational unit id (or its external 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 to add as approver. Provide either personId or personExternalId.

string
length ≤ 255

External source identifier of the person to add as approver. Used when the caller identifies persons by their external system id. Ignored if personId is also provided.

double | null
≥ 0

Optional maximum expense report amount this approver is authorized to approve, expressed in the organization's base currency.

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?