mcp_gateway

Team guardrails evaluated before any scope policy.

post/api/projects/{project_id}/mcp_gateway/rules/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/mcp_gateway/rules/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

idstring uuid required
namestring required

Short rule name shown wherever the rule locks a tool.

descriptionstring

Why this guardrail exists.

applies_to'everyone' | 'members' | 'agents'
  • everyone - Everyone
  • members - Members
  • agents - Agents
effect'needs_approval' | 'do_not_use'
  • needs_approval - Require approval
  • do_not_use - Block
tool_patternstring

fnmatch pattern against tool names. Blank matches destructive tools heuristically.

enabledboolean

Disabled rules are kept but not evaluated.

created_atstring date-time required
updated_atstring date-time required

Response

idstring uuid required
namestring required

Short rule name shown wherever the rule locks a tool.

descriptionstring

Why this guardrail exists.

applies_to'everyone' | 'members' | 'agents'
  • everyone - Everyone
  • members - Members
  • agents - Agents
effect'needs_approval' | 'do_not_use'
  • needs_approval - Require approval
  • do_not_use - Block
tool_patternstring

fnmatch pattern against tool names. Blank matches destructive tools heuristically.

enabledboolean

Disabled rules are kept but not evaluated.

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.