Ga naar inhoud

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.

Gemeten op 8 november 2026.

ProductStandHoe de goedgekeurde aanroep terugkomt
LEO-familieOp productie, voor de schrijfacties die er staan: gesprekken verwijderen en terugzetten. Kennisbanken volgen binnenkort.Dezelfde aanroep met de header x-prudai-approval: <approval-id>
IRMAAfgedwongen per organisatie waarvoor de poort is ingeschakeld.Dezelfde aanroep met de header X-Prudai-Approval-Grant
ORDOOp productie. De goedkeuringspoort is per organisatie in te stellen: uit, schaduw (vastleggen) of afdwingen.POST /v1/approvals/{id}/execute

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.

  1. 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": "..."
    }
    }
  2. Een mens beslist in de Prudai Console, onder Goedkeuringen. Een agent of sleutel kan zichzelf niet goedkeuren. Bij review is dat een beheerder, met een reden.

  3. 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.

  • CLI: een schrijfactie die wacht geeft exit 2 en de goedkeuringslink. prudai approvals wait <id> --product <product> --execute wacht op de beslissing en voert daarna uit. De CLI keurt nooit zelf goed. Zie CLI.
  • MCP: execute_tool geeft approval_required terug. Zie MCP.
  • Alles met kosten of betaling wacht op een mens. Een agent maakt nooit zelf geld over.