workflow_grant_request

Tool

workflow_grant_request

Ask Governance again for every tool the workflow's live version calls.

Ask Governance again for every tool the workflow's live version calls. Use it after a grant was revoked: Governance does not resurrect a revoked grant when a human approves it, so it has to be requested again first — this puts it back to pending, where an Owner or Admin can sponsor it. Idempotent; grants nothing by itself.

Behavior

HTTP: POST /workflow/grant/request

Arguments

Name	Type	Required	Description
workflow_id	string	•	No description in the catalog.

Response

Field	Type	Always	Description
hint	string	•	What to do next, when something needs doing; null when nothing does.
grants	array	•
pending	array	•	Tool keys asked for and waiting on a human.
revoked	array	•	Tool keys a human withdrew. Approving one again is not enough: Governance does not resurrect a revoked grant, so it has to be asked for first.
effective	array	•	Tool keys the workflow may call right now.
workflow_id	string	•
approve_with	string	•	Where a pending grant is approved, and by whom.
needs_sponsor	array	•	Tool keys that were approved and lost their sponsor.

Try it

Ask Governance again for every tool the workflow's live version calls.

When to use

Example

Ask your agent something like this:

Ask Governance again for every tool the workflow's live version calls.

The agent will invoke workflow_grant_request with these arguments:

{
  "workflow_id": "<workflow_id>"
}