Get a version

GET

api

pages

{page_id}

versions

{version}

curl "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/versions/3?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

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

const { version, content } = await res.json()

import os, requests

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

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

{
  "ok": true,
  "version": {
    "version": 3,
    "size_bytes": 2011,
    "created_by_source": "api",
    "change_note": "hourly",
    "content_sha256": "9d1e0f…",
    "created_at": "2026-09-21T06:00:00.000Z"
  },
  "content": "<!doctype html>…"
}

{
  "ok": false,
  "error": { "code": "VERSION_NOT_FOUND", "message": "No such version." }
}

Read a specific version, for example to diff two runs of a scheduled report, or to fetch the HTML you want to roll back to.

Authorization

string

required

Bearer mac_live_…

Path parameters

string

required

The Page’s id.

integer

required

A positive integer. Anything else is 422 VALIDATION_FAILED.

Query parameters

string

content to include the HTML.

Response

boolean

true on success.

object

version, size_bytes, created_by_source, change_note, content_sha256 and created_at, as in List versions.

string

The HTML. Only with include=content, and at the top level, not inside version.

curl "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/versions/3?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

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

const { version, content } = await res.json()

import os, requests

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

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

{
  "ok": true,
  "version": {
    "version": 3,
    "size_bytes": 2011,
    "created_by_source": "api",
    "change_note": "hourly",
    "content_sha256": "9d1e0f…",
    "created_at": "2026-09-21T06:00:00.000Z"
  },
  "content": "<!doctype html>…"
}

{
  "ok": false,
  "error": { "code": "VERSION_NOT_FOUND", "message": "No such version." }
}

Errors

Status	Code	Meaning
`401`	`INVALID_API_KEY`	Missing, broken, or revoked.
`404`	`NOT_FOUND`	No live Page with that id in this workspace.
`404`	`VERSION_NOT_FOUND`	That version was pruned, or never existed.
`422`	`VALIDATION_FAILED`	`version` is not a positive integer.
`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/$PAGE_ID/versions/3?include=content" \
  -H "Authorization: Bearer $MAC_KEY"

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

const { version, content } = await res.json()

import os, requests

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

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

{
  "ok": true,
  "version": {
    "version": 3,
    "size_bytes": 2011,
    "created_by_source": "api",
    "change_note": "hourly",
    "content_sha256": "9d1e0f…",
    "created_at": "2026-09-21T06:00:00.000Z"
  },
  "content": "<!doctype html>…"
}

{
  "ok": false,
  "error": { "code": "VERSION_NOT_FOUND", "message": "No such version." }
}

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