docs: add Global Accounts agent guides

[k15z]

Summary

• add a new Agents (experimental) section under Global Accounts
• add overview, policy/permissions, and approvals/audit guides for agent connectivity
• link the new section from the Global Accounts landing page and align the content with existing docs patterns

Testing

• verified the three new docs routes returned 200 OK in the local Mintlify preview
• did not run a full lint/build pass

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
grid-flow-builder	Ready	Preview, Comment	May 1, 2026 0:02am

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Grid	🟢 Ready	View Preview	Apr 30, 2026, 4:01 PM

[greptile-apps]

Greptile Summary

This PR adds a new "Agents (experimental)" section under Global Accounts, comprising three guides (overview, policies & permissions, and approvals & audit) plus nav entries in docs.json and a landing-page card. Content structure, frontmatter, code block language tags, icon paths, and snippet imports all conform to the established docs patterns.

Confidence Score: 4/5

Safe to merge after verifying the "OpenClaw" product name is intentional or replacing it with a real tool.

Only P2 findings present; the single concern is a potentially fabricated third-party product name in a documentation example. All structural, navigation, and style requirements are met.

mintlify/global-accounts/agents/overview.mdx — verify the "OpenClaw" product reference on line 14.

Important Files Changed

Filename	Overview
mintlify/docs.json	Adds "Agents (experimental)" nav group with 3 new pages; correctly placed within the Global Accounts section.
mintlify/global-accounts/agents/overview.mdx	New overview page with proper frontmatter, mermaid sequence diagram, and FeatureCards; "OpenClaw" is a non-existent tool name that should be replaced.
mintlify/global-accounts/agents/policies-and-permissions.mdx	New policies guide with proper frontmatter, annotated JSON example, and well-structured spending limits / approval threshold documentation.
mintlify/global-accounts/agents/approvals-and-audit.mdx	New approvals/audit guide with proper frontmatter, clear lifecycle steps, idempotency guidance, and a realistic JSON approval record example.
mintlify/global-accounts/index.mdx	Adds an "Agents (experimental)" card linking to the new overview page; follows existing card pattern correctly.

Sequence Diagram

sequenceDiagram
    participant U as User
    participant P as Partner app
    participant G as Grid
    participant A as Connected agent

    U->>P: Connect agent
    P->>G: Start Grid-powered install flow
    G-->>P: Agent connection + delegated credentials

    A->>G: Request action
    alt Auto-execute (policy allows)
        G-->>A: Action executed
    else Approval required
        G-->>P: Permission request
        P-->>U: Show approval UI
        U->>P: Approve or reject
        P->>G: Send decision
        G-->>P: Action executed or rejected
    end

    G-->>P: Activity, transaction, and audit updates

Loading

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
mintlify/global-accounts/agents/overview.mdx:14
**Unverified product name "OpenClaw"**

`OpenClaw` does not appear to be a recognized AI agent tool or product — it is not mentioned anywhere else in the repo or in publicly known tooling. The style guide requires that documentation never lie, guess, or make up information. If this is meant to illustrate a third-party agent tool alongside Codex, replace it with a real, verifiable product name (e.g., `Claude`, `Cursor`, `AutoGPT`) or use a generic placeholder such as "a third-party agent tool."

_{Reviews (1): Last reviewed commit: "docs: polish agent docs for review" | Re-trigger Greptile}