generate_agent_page
Create a page on the brand's agent site and generate its content with AI in the background.
Create a new page on the brand's Pendium-hosted agent site (served at /{username}) and generate its content with AI. The page is created immediately as a draft shell, then a background job fills in the hero and sections. This tool returns right away — poll list_agent_pages until the page reports generating: false. For local service-area landing pages, use generate_service_area_pages instead.
Authentication: Required. The agent's owning account must have available credits (a Starter or Pro plan) — the background content generation uses LLM credits, billed to the owner.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | integer | Yes | The agent ID to add the page to. |
title | string (1–200) | Yes | Human-readable page title. Shows as the hero headline and in nav. |
slug | string (1–200) | Yes | URL slug — the page resolves to /{username}/{slug}. Lowercase letters, numbers, and hyphens only. Must be unique per agent and cannot be a reserved slug (profile, faq, services, resources, service-areas). |
category | enum | No | Nav placement. product (default) = an offering, shown in the Products/Services nav. resource = a topic/pillar page, shown in the Resources nav. |
Returns
agentPageId, plus the syntheticId, slug, title, and category. The page starts as a draft with placeholder content; poll list_agent_pages and wait for generating: false, then publish it with publish_agent_page.