swagger_create_table_of_contents
Create a new table of contents item in a portal product section. Supports API references, HTML content, and Markdown content types. Parameters: - sectionId (string) *required*: Section ID - unique identifier for the section within the product - type (enum) *required*: Type of table of contents cr...
This record as markdown: /tools/smartbear-mcp/swagger-create-table-of-contents.md
What swagger_create_table_of_contents does on SmartBear MCP
AI agents use swagger_create_table_of_contents to create or update resources in SmartBear MCP, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your SmartBear MCP environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | URL-friendly identifier for the table of contents item - must be unique within the section (3-22 characters, lowercase, alphanumeric with hyphens/underscores/do |
type | string | Yes | Type of table of contents creation - 'new' to create from scratch or 'copy' to duplicate an existing one |
order | number | Yes | Order position of the table of contents item within its parent section or item |
title | string | Yes | Title of the table of contents item - will be displayed in navigation (3-40 characters) |
content | object | — | Content configuration for the table of contents item |
parentId | object | — | Parent table of contents item ID - null for top-level items, or ID of parent item for nested structure |
sectionId | string | Yes | Section ID - unique identifier for the section within the product |
Parameters from the server's own tool schema.
Why swagger_create_table_of_contents is rated Medium
This tool creates new documentation/navigation artifacts (table of contents items) that modify the portal's structure and are persisted. This is reversible (items can be deleted/modified later), making it a Write operation rather than Read (it changes state) or Destructive (creation is reversible).
From the tool's definition Tool performs 'Create a new table of contents item' in a portal product section. Parameters include required fields for title, slug, and section targeting, indicating persistent creation of navigation/content structure elements.
Risk signalsAccepts raw HTML/template content (content) · Accepts URL/endpoint input (content.url) · High parameter count (12 properties)
Attacks that exploit this kind of access
The rule that runs swagger_create_table_of_contents safely
PolicyLayer is an MCP gateway: it sits between your AI agents and SmartBear MCP, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For swagger_create_table_of_contents, this is the rule to start with:
swagger_create_table_of_contents stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect SmartBear MCP, apply this rule, and every swagger_create_table_of_contents call is checked against it from then on.
Questions about swagger_create_table_of_contents
Create a new table of contents item in a portal product section. Supports API references, HTML content, and Markdown content types. Parameters: - sectionId (string) *required*: Section ID - unique identifier for the section within the product - type (enum) *required*: Type of table of contents creation - 'new' to create from scratch or 'copy' to duplicate an existing one - title (string) *required*: Title of the table of contents item - will be displayed in navigation (3-40 characters) - slug (string) *required*: URL-friendly identifier for the table of contents item - must be unique within the section (3-22 characters, lowercase, alphanumeric with hyphens/underscores/dots) - order (number) *required*: Order position of the table of contents item within its parent section or item - parentId (string): Parent table of contents item ID - null for top-level items, or ID of parent item for nested structure - content (object): Content configuration for the table of contents item. It is categorised as a Write tool in the SmartBear MCP MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
swagger_create_table_of_contents accepts 7 parameters: slug, type, order, title, content, parentId, sectionId. Required: slug, type, order, title, sectionId. The full parameter table on this page comes from the server's own tool schema.
Register the SmartBear MCP server in PolicyLayer and add a rule for swagger_create_table_of_contents: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches SmartBear MCP. Nothing to install.
swagger_create_table_of_contents is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the swagger_create_table_of_contents rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for swagger_create_table_of_contents. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
swagger_create_table_of_contents is provided by the SmartBear MCP server (SmartBear/smartbear-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on SmartBear, and thousands of servers like it.
This server
Across the catalogue