Skip to content

docs(agents): add webhook and account model links#434

Open
k15z wants to merge 1 commit intomainfrom
docs/agents-webhook-and-account-model-links
Open

docs(agents): add webhook and account model links#434
k15z wants to merge 1 commit intomainfrom
docs/agents-webhook-and-account-model-links

Conversation

@k15z
Copy link
Copy Markdown
Contributor

@k15z k15z commented May 1, 2026

Summary

  • Link webhook mentions in the agents overview and approvals pages to /global-accounts/platform-tools/webhooks
  • Link "internal accounts" in the policies & permissions page to /platform-overview/core-concepts/account-model to clarify terminology

Test plan

  • Verify internal links resolve correctly in the Mintlify dev server

Link webhook mentions to /global-accounts/platform-tools/webhooks in the
overview and approvals pages. Link "internal accounts" in policies page
to /platform-overview/core-concepts/account-model.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 1, 2026

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

Project Deployment Actions Updated (UTC)
grid-flow-builder Ready Ready Preview, Comment May 1, 2026 8:54pm

Request Review

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 1, 2026

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

Project Status Preview Updated (UTC)
Grid 🟢 Ready View Preview May 1, 2026, 8:56 PM

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 1, 2026

Greptile Summary

This PR adds contextual hyperlinks in three agents documentation pages: webhook mentions in approvals-and-audit.mdx and overview.mdx now point to /global-accounts/platform-tools/webhooks, and "internal accounts" in policies-and-permissions.mdx links to /platform-overview/core-concepts/account-model. Both link targets were verified to exist in the repo.

Confidence Score: 4/5

Safe to merge — all link targets verified; only a minor formatting nit present

All three new links resolve to existing .mdx files; link format is consistent with existing conventions in the repo. The only finding is a P2 style issue (a blank line accidentally removed before a heading in approvals-and-audit.mdx).

mintlify/global-accounts/agents/approvals-and-audit.mdx — minor blank-line removal before a heading

Important Files Changed

Filename Overview
mintlify/global-accounts/agents/approvals-and-audit.mdx Adds two webhook links pointing to /global-accounts/platform-tools/webhooks; a blank line before one heading was accidentally removed
mintlify/global-accounts/agents/overview.mdx Adds one webhook link to /global-accounts/platform-tools/webhooks; target file confirmed to exist
mintlify/global-accounts/agents/policies-and-permissions.mdx Links "internal accounts" to /platform-overview/core-concepts/account-model; target file confirmed to exist

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["agents/overview.mdx"] -->|"webhook link added"| W["platform-tools/webhooks"]
    B["agents/approvals-and-audit.mdx"] -->|"2 webhook links added"| W
    C["agents/policies-and-permissions.mdx"] -->|"internal accounts link added"| M["core-concepts/account-model"]
Loading

Fix All in Claude Code

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/approvals-and-audit.mdx:114
**Missing blank line before heading**

The blank line that previously separated the "Pause and revoke" section body from the `## What to show in the approval UI` heading was accidentally removed in this diff. Mintlify (and most Markdown renderers) typically render headings cleanly without the blank line, but it is inconsistent with the surrounding section separators in this file and departs from the repo's formatting conventions.

```suggestion
Grid enforces these controls. Your product should surface the current connection state and expose the relevant actions in your own experience.

## What to show in the approval UI
```

Reviews (1): Last reviewed commit: "docs(agents): add webhook and account mo..." | Re-trigger Greptile


Grid enforces these controls. Your product should surface the current connection state and expose the relevant actions in your own experience.

## What to show in the approval UI
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Missing blank line before heading

The blank line that previously separated the "Pause and revoke" section body from the ## What to show in the approval UI heading was accidentally removed in this diff. Mintlify (and most Markdown renderers) typically render headings cleanly without the blank line, but it is inconsistent with the surrounding section separators in this file and departs from the repo's formatting conventions.

Suggested change
## What to show in the approval UI
Grid enforces these controls. Your product should surface the current connection state and expose the relevant actions in your own experience.
## What to show in the approval UI
Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/global-accounts/agents/approvals-and-audit.mdx
Line: 114

Comment:
**Missing blank line before heading**

The blank line that previously separated the "Pause and revoke" section body from the `## What to show in the approval UI` heading was accidentally removed in this diff. Mintlify (and most Markdown renderers) typically render headings cleanly without the blank line, but it is inconsistent with the surrounding section separators in this file and departs from the repo's formatting conventions.

```suggestion
Grid enforces these controls. Your product should surface the current connection state and expose the relevant actions in your own experience.

## What to show in the approval UI
```

How can I resolve this? If you propose a fix, please make it concise.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants