Goedkeuringen
Elke operatie heeft een goedkeuringsniveau (x-prudai-approval in de spec). Het staat in de referentie bij elke operatie. Lezen vraagt nooit een goedkeuring. Bij schrijven door een agent kijkt een mens mee, tenzij het niveau anders zegt.
De stand per product
Section titled “De stand per product”Gemeten op 8 november 2026.
| Product | Stand | Hoe de goedgekeurde aanroep terugkomt |
|---|---|---|
| LEO-familie | Op productie, voor de schrijfacties die er staan: gesprekken verwijderen en terugzetten. Kennisbanken volgen binnenkort. | Dezelfde aanroep met de header x-prudai-approval: <approval-id> |
| IRMA | Afgedwongen per organisatie waarvoor de poort is ingeschakeld. | Dezelfde aanroep met de header X-Prudai-Approval-Grant |
| ORDO | Op productie. De goedkeuringspoort is per organisatie in te stellen: uit, schaduw (vastleggen) of afdwingen. | POST /v1/approvals/{id}/execute |
De niveaus
Section titled “De niveaus”none
Geen extra stap. Lezen, of rekenen zonder iets op te slaan.
instruct
Niet blokkerend. De agent noemt zijn bedoeling.
confirm
De gebruiker bevestigt precies deze aanroep. Standaard voor POST, PUT en PATCH.
review
Een tweede persoon of rol keurt goed. Standaard voor DELETE.
forbidden_for_agents
Nooit door een agent, alleen door een mens in de app. Het antwoord blijft 403 forbidden_for_agents, ook met een goedkeuring.
Zo gaat een goedkeuring
Section titled “Zo gaat een goedkeuring”-
De aanroep zonder goedkeuring voert niets uit en antwoordt
202:{"approvalRequest": {"id": "apr_...","level": "confirm","operation": "...","method": "POST","path": "...","args_hash": "...","expires_at": "...","approval_url": "..."}} -
Een mens beslist in de Prudai Console, onder Goedkeuringen. Een agent of sleutel kan zichzelf niet goedkeuren. Bij
reviewis dat een beheerder, met een reden. -
De aanroeper herhaalt dezelfde aanroep met de header:
x-prudai-approval: apr_...
De server voert precies de goedgekeurde aanroep uit: args_hash is de hash van operatie, pad, query en body. Een gewijzigde body, een andere route of een tweede gebruik wordt geweigerd. Een aanvraag staat 15 minuten open; een goedkeuring is daarna 10 minuten geldig en werkt één keer.
Met ?dryRun=true zie je wat er zou gebeuren, zonder goedkeuring en zonder iets op te slaan. Elke aanvraag, beslissing en uitvoering komt in de audittrail.
Vanuit de CLI en MCP
Section titled “Vanuit de CLI en MCP”- CLI: een schrijfactie die wacht geeft exit 2 en de goedkeuringslink.
prudai approvals wait <id> --product <product> --executewacht op de beslissing en voert daarna uit. De CLI keurt nooit zelf goed. Zie CLI. - MCP:
execute_toolgeeftapproval_requiredterug. Zie MCP. - Alles met kosten of betaling wacht op een mens. Een agent maakt nooit zelf geld over.