rejectWorksheets

Mutation

Rejects a selection of submitted or PM approved worksheets, one at a time, by running rejectWorksheet for each — so each one releases its lines' claims on their source rows, appends its approval-chain step and notifies exactly once. A worksheet that cannot be rejected is reported in results and leaves the rest of the selection untouched.

Access: Requires the finance feature and the worksheet review permission — the same permission rejectWorksheet enforces, asserted per worksheet. Ids are confined to workspaceId, so a worksheet in another workspace is reported as not found rather than by its status.

Errors: Throws when the user is not logged in, the workspace has finance disabled, the selection is empty, or it names more worksheets than one run allows. Everything a single rejection can refuse — a missing worksheet, a status that cannot be rejected, a missing rejection reason, a lacking permission — is reported per row in results rather than thrown.

Returns FinanceBulkMutationResult !.