Skip to main content
Approve, as yourself, the validation-workflow stage awaiting you on statements. Refused when the company’s validation workflow is off. The usual chain: call list_statements with approver_id set to your own id to find what awaits you, then call this tool with those ids (the id of the statement rows, not user ids), at most 50 per call. Approving needs no write permission: you approve as yourself, on the statements you can see where you are one of a stage’s approvers. Each statement sent gets one row:
  • approved: your approval is recorded on one stage.
  • skipped, with the reason in reason: you are not one of its approvers, your stage waits on an earlier mandatory stage, your stages are already complete, it is already paid, no validation is requested on it, or it changed while the call ran.
  • failed on Qobra’s side, in which case the approval may be recorded. reason says what to do.
One call approves one stage per statement. When another stage still awaits you on a statement, its row’s warning says so, and another call approves it. To approve a specific stage, pass its stage_position with a single statement id. An approval cannot be undone and there is no rejection: an approval is the only decision a stage takes. A stage your approval completes moves the workflow on, and Qobra notifies the approvers whose turn comes, as in the web app. Once no mandatory stage awaits approval, pay the statement with update_statements_status. The whole call is refused before anything is approved when an id names no statement you can see. Available only where the validation workflow is switched on. Every approval in the live environment is recorded in the audit trail as the Qobra MCP agent.

Parameters

Body

string[]
required
The id of rows of list_statements, not user ids: list_statements with approver_id set to your own id lists those awaiting you. At most 50.
integer
The 1-based position of the stage to approve, as get_statement shows it under validation_workflow; with a single statement id only. Omit it to approve the stage awaiting you on each statement: your mandatory one first, else your first optional one.

Example

Response

Body

object[]
One row per statement, in the order first sent: an id sent twice is approved and reported once.