Roll back

POST

api

pages

{page_id}

rollback

curl -X POST "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/rollback" \
  -H "Authorization: Bearer $MAC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to_version": 3, "change_note": "Revert the broken chart" }'

const res = await fetch(
  `https://app.my-aichatbot.com/api/v1/pages/${pageId}/rollback`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.MAC_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ to_version: 3, change_note: 'Revert the broken chart' })
  }
)

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

import os, requests

res = requests.post(
    f"https://app.my-aichatbot.com/api/v1/pages/{page_id}/rollback",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    json={"to_version": 3, "change_note": "Revert the broken chart"},
)

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

{
  "ok": true,
  "version": 6,
  "copied_from": 3,
  "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
  "version_url": "https://acme.my-aichatbot-space.com/sales-report/v/6"
}

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

Rolling back never rewrites history. The chosen version’s HTML is copied into a new version, which becomes current, so every /v/{n} URL keeps meaning what it always meant. Needs a key with Pages write turned on, and the Page must belong to the key’s bot.

Authorization

string

required

Bearer mac_live_…

Path parameters

string

required

The Page’s id.

Body

integer

required

The kept version to copy.

string

Up to 500 characters, shown next to the new version in the app.

Response

boolean

true on success.

integer

The new version number. If the chosen version is identical to the current one, nothing new is stored and this is the current number.

integer

The version that was copied.

string

The Page’s link.

string

The permanent /v/{n} address of the new version.

curl -X POST "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/rollback" \
  -H "Authorization: Bearer $MAC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to_version": 3, "change_note": "Revert the broken chart" }'

const res = await fetch(
  `https://app.my-aichatbot.com/api/v1/pages/${pageId}/rollback`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.MAC_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ to_version: 3, change_note: 'Revert the broken chart' })
  }
)

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

import os, requests

res = requests.post(
    f"https://app.my-aichatbot.com/api/v1/pages/{page_id}/rollback",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    json={"to_version": 3, "change_note": "Revert the broken chart"},
)

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

{
  "ok": true,
  "version": 6,
  "copied_from": 3,
  "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
  "version_url": "https://acme.my-aichatbot-space.com/sales-report/v/6"
}

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

Errors

Status	Code	Meaning
`401`	`INVALID_API_KEY`	Missing, broken, or revoked.
`402`	`STORAGE_QUOTA_EXCEEDED`	Workspace storage is full.
`403`	`PAGES_WRITE_DISABLED`	Turn on Pages write for this key.
`403`	`FORBIDDEN_CHATBOT`	The Page belongs to another bot.
`403`	`PAGE_DISABLED`	The Page was disabled by an admin. Writes are rejected.
`404`	`NOT_FOUND`	No live Page with that id in this workspace.
`404`	`VERSION_NOT_FOUND`	That version was pruned, or never existed.
`413`	`CONTENT_TOO_LARGE`	The old version is bigger than your current plan’s cap.
`422`	`VALIDATION_FAILED`	Bad body.
`429`	`RATE_LIMITED`	Over 120 writes per minute for this key. Wait for `retry_after_seconds`.
`500`	`PERSIST_FAILED`	We could not store the version. Safe to retry.

curl -X POST "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/rollback" \
  -H "Authorization: Bearer $MAC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to_version": 3, "change_note": "Revert the broken chart" }'

const res = await fetch(
  `https://app.my-aichatbot.com/api/v1/pages/${pageId}/rollback`,
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.MAC_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ to_version: 3, change_note: 'Revert the broken chart' })
  }
)

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

import os, requests

res = requests.post(
    f"https://app.my-aichatbot.com/api/v1/pages/{page_id}/rollback",
    headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
    json={"to_version": 3, "change_note": "Revert the broken chart"},
)

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

{
  "ok": true,
  "version": 6,
  "copied_from": 3,
  "url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
  "version_url": "https://acme.my-aichatbot-space.com/sales-report/v/6"
}

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

Overview

Messages

Files

Pages

Authorization

Path parameters

Body

Response

Errors

​Authorization

​Path parameters

​Body

​Response

​Errors

Authorization

Path parameters

Body

Response

Errors