Update main approval setup

put

https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/{approvalId}

Updates the main approval setup for an organization. The approval workflow must already be active (created via POST) before it can be updated. The approvalId path parameter must match the id of the existing approval setup for the organization. The organizationId path parameter supports both the Findity id and the partner-side externalId.

Path Params

organizationId

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

approvalId

string

required

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

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

Body Params

numberOfRequiredApprovals

integer

1 to 3

Number of sequential approvals an expense report must receive before it can be submitted. Only applicable when requiresApproval is true. Must be between 1 and 3.

defaultApprover

object

The person designated as the default approver when no other approver is assigned to a submitter. Required when requiresApproval is true. Identify the person by providing either their Findity id or their externalId. In case that id is provided, externalId will be disregarded.

Responses

200Approval setup successfully updated

400Bad request

404Not found error