Set the display order of a financier's approvals

Takes the approval ids in the order they should appear, top first, and rewrites their priority values to match. Priority decides which approval heads a financier’s Matrix results; sending the order means a client never has to know what the underlying numbers are.

Values are spaced evenly so a number can still be typed between two rows afterwards. Every id must belong to the same organisation, and all of them are rewritten in one transaction — a request naming an unknown id changes nothing.

Authentication

AuthorizationBearer

JWT access token obtained from POST /api/v1/auth/login, or a finput_sk_... API token

Request

This endpoint expects an object.

approval_idslist of integersRequired

Approval ids, first in the list sorts first.

Response

The order that was applied

approval_idslist of integersOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error