Get a page by slug

GET

api

pages

by-slug

{slug}

curl "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

const res = await fetch(
  'https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content',
  { headers: { Authorization: `Bearer ${process.env.MAC_KEY}` } }
)

const { page } = await res.json()

import os, requests

res = requests.get(
    "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    params={"include": "content"},
)

page = res.json()["page"]

{
  "ok": true,
  "page": {
    "id": "9b3f11c2-…",
    "slug": "sales-report",
    "title": "Sales report",
    "description": null,
    "visibility": "private",
    "chatbot_id": "c1a2…",
    "conversation_id": null,
    "current_version": 4,
    "version_count": 4,
    "total_bytes": 8192,
    "disabled_reason": null,
    "created_at": "2026-09-21T03:00:00.000Z",
    "updated_at": "2026-09-21T07:00:00.000Z",
    "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
    "content": "<!doctype html>…"
  }
}

{
  "ok": false,
  "error": { "code": "NOT_FOUND", "message": "No page with that slug in this workspace." }
}

The read half of the by-slug handle. Resolves the Page that holds this slug now, or the Page that held it before a rename, so a job that only knows its slug can check what is live. The response carries the Page’s current slug.

Authorization

string

required

Bearer mac_live_…

Path parameters

string

required

1 to 63 lowercase letters, digits and dashes. Anything else is 422 VALIDATION_FAILED.

Query parameters

string

content to include the current version’s HTML.

Response

boolean

true on success.

object

The Page, with content when you asked for it. Same fields as Get a page.

curl "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

const res = await fetch(
  'https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content',
  { headers: { Authorization: `Bearer ${process.env.MAC_KEY}` } }
)

const { page } = await res.json()

import os, requests

res = requests.get(
    "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    params={"include": "content"},
)

page = res.json()["page"]

{
  "ok": true,
  "page": {
    "id": "9b3f11c2-…",
    "slug": "sales-report",
    "title": "Sales report",
    "description": null,
    "visibility": "private",
    "chatbot_id": "c1a2…",
    "conversation_id": null,
    "current_version": 4,
    "version_count": 4,
    "total_bytes": 8192,
    "disabled_reason": null,
    "created_at": "2026-09-21T03:00:00.000Z",
    "updated_at": "2026-09-21T07:00:00.000Z",
    "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
    "content": "<!doctype html>…"
  }
}

{
  "ok": false,
  "error": { "code": "NOT_FOUND", "message": "No page with that slug in this workspace." }
}

Errors

Status	Code	Meaning
`401`	`INVALID_API_KEY`	Missing, broken, or revoked.
`404`	`NOT_FOUND`	No live Page holds or held this slug.
`422`	`VALIDATION_FAILED`	Bad slug.
`429`	`RATE_LIMITED`	Over 300 reads per minute for this key. Wait for `retry_after_seconds`.

curl "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

const res = await fetch(
  'https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report?include=content',
  { headers: { Authorization: `Bearer ${process.env.MAC_KEY}` } }
)

const { page } = await res.json()

import os, requests

res = requests.get(
    "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    params={"include": "content"},
)

page = res.json()["page"]

{
  "ok": true,
  "page": {
    "id": "9b3f11c2-…",
    "slug": "sales-report",
    "title": "Sales report",
    "description": null,
    "visibility": "private",
    "chatbot_id": "c1a2…",
    "conversation_id": null,
    "current_version": 4,
    "version_count": 4,
    "total_bytes": 8192,
    "disabled_reason": null,
    "created_at": "2026-09-21T03:00:00.000Z",
    "updated_at": "2026-09-21T07:00:00.000Z",
    "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
    "content": "<!doctype html>…"
  }
}

{
  "ok": false,
  "error": { "code": "NOT_FOUND", "message": "No page with that slug in this workspace." }
}

Overview

Messages

Files

Pages

Authorization

Path parameters

Query parameters

Response

Errors

​Authorization

​Path parameters

​Query parameters

​Response

​Errors

Authorization

Path parameters

Query parameters

Response

Errors