Grid82
grid82.comJoin the waitlist
UseApprovals

Workflow approvals

Review, approve, or reject human-in-the-loop workflow requests directly from the Runtime approval queue.

Grid82 workflows can pause mid-execution with approval.ask and wait for a human decision from a specific role. Whenever a workflow waits on one of your roles, the top bar displays a live to approve counter.

Runtime approvals drawer displaying pending workflow approval card and Approve button ringed in red

Reviewing a pending discount sign-off in the Runtime approval drawer with the Approve action highlighted

Reviewing a request

Click to approve in the header to open the pending queue:

  1. Read the question configured by the workflow author (for example, approving an enterprise deal discount).
  2. Inspect the context summary shown on the card. Workflows pass only the fields listed in show, letting approvers verify the key facts directly.
  3. Add an optional decision note explaining your reasoning (saved with the approval record for auditing).
  4. Click Approve (ringed in red) or Reject.

What happens after you decide

  • The paused workflow wakes up immediately and receives { approved: true | false, by, at, note }.
  • Your decision is stamped with your user identity and removed from the queue for other members of the same role so a request cannot be approved twice.
  • If no member decides before the workflow’s timeout (default 7 days, up to 30 days), the request expires with { approved: false, timedOut: true } and clears from the queue.
  • You can also list and decide pending approvals programmatically via approvals.list and approvals.decide, or through MCP.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Grid82 documentation and read it in full, instead of answering from memory.

https://grid82.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://grid82.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.