Public Agent Pages

Agent Pages are deprecated. Use Public Genies for new integrations.

These routes use resource: "agent-pages" and require no API key. They serve the legacy Agent Page embed and access-request flow.

Actions

`url`

Loads an Agent Page by its URL slug. Returns the full page record with the joined Genie data. Validates access for private Genies via an access token header. Parameters

Field	Type	Required	Description
`url_name`	string	Yes	URL slug of the Agent Page

Headers

Header	Description
`X-Agent-Access-Token`	Access grant token for private Genies. Required if the Genie is not public.

Response

{
  "agentPage": {
    "id": "page-uuid",
    "url_name": "support-bot",
    "welcome_message": "How can I help you today?",
    "info_links": [ ],
    "agents": {
      "id": "agent-uuid",
      "name": "Support Genie",
      "elevenlabs_id": "el-agent-id",
      "settings": { },
      "branding": { },
      "is_active": true,
      "is_public": true
    }
  }
}

Private Genie error (when Genie is not public and no valid token):

{
  "success": false,
  "error": {
    "code": "GENIE_PRIVATE",
    "message": "This Genie is private",
    "status": 403,
    "genieName": "Support Genie"
  }
}

Access tokens are validated against agent_access_grants. Each valid use increments the grant’s use_count.

`request-access`

Submits an access request for a private Agent Page. Notifies the Genie owner by email. If the requester does not have a HelpGenie account, one is created automatically with a welcome email and set-password link. Parameters

Field	Type	Required	Description
`url_name`	string	Yes	URL slug of the Agent Page
`email`	string	Yes	Requester’s email address

Response

{ "success": true }

Only valid for private Genies (is_public: false). Returns VALIDATION_ERROR if the Genie is already public.

Error codes

Code	Meaning
`VALIDATION_ERROR`	Missing required parameter or Genie is already public
`NOT_FOUND`	Agent Page not found
`GENIE_PRIVATE`	Genie is private and no valid access token was provided
`FORBIDDEN`	Access denied
`INTERNAL_ERROR`	Unexpected server error

Overview

Public (unauthenticated)

Agents

Knowledge

CRM

Marketplace

Platform

Telephony

Worker genies

Quality & Compliance

Access Control

Intelligence

Education

Voice

Integrations

Expanded Platform

Actions

`url`

`request-access`

Error codes

​Actions

​url

​request-access

​Error codes

Actions

`url`

`request-access`

Error codes