> ## Documentation Index
> Fetch the complete documentation index at: https://docs.my-aichatbot.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Publish a new version
> Replace a Page's HTML by adding a version. The Page's URL serves it right away.
Add a version to a Page owned by the key's bot. Needs a key with **Pages write** turned on. The Page's main URL serves the new version right away. The previous one stays reachable at its `/v/{n}` address until it is pruned.
## Authorization
`Bearer mac_live_…`
## Path parameters
The Page's id.
## Body
The full HTML document. Up to your plan's per-version cap.
Up to 500 characters, shown next to the version in the app.
## Response
`true` on success.
The new version number, or the current one when `deduplicated`.
The Page's link.
The permanent `/v/{n}` address of this version.
SHA-256 of the stored content.
`true` when the content was byte-for-byte identical to the current version, so nothing new was stored. A revision loop that gets stuck cannot burn through your version history.
```bash curl theme={null}
curl -X PUT "https://app.my-aichatbot.com/api/v1/pages/$PAGE_ID/content" \
-H "Authorization: Bearer $MAC_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "SalesSales, revised
",
"change_note": "Sticky header"
}'
```
```javascript Node.js theme={null}
const res = await fetch(
`https://app.my-aichatbot.com/api/v1/pages/${pageId}/content`,
{
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.MAC_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ content: html, change_note: 'Sticky header' })
}
)
const { version, deduplicated } = await res.json()
```
```python Python theme={null}
import os, requests
res = requests.put(
f"https://app.my-aichatbot.com/api/v1/pages/{page_id}/content",
headers={"Authorization": f"Bearer {os.environ['MAC_KEY']}"},
json={"content": html, "change_note": "Sticky header"},
)
version = res.json()["version"]
```
```json 200 OK theme={null}
{
"ok": true,
"version": 5,
"url": "https://app.my-aichatbot.com/pages/view/acme/sales-report",
"version_url": "https://acme.my-aichatbot-space.com/sales-report/v/5",
"content_sha256": "c0ffee…",
"deduplicated": false
}
```
```json 413 Too large theme={null}
{
"ok": false,
"error": {
"code": "CONTENT_TOO_LARGE",
"message": "Content exceeds your plan's per-version cap (524288 bytes).",
"limit_bytes": 524288
}
}
```
## 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. |
| `413` | `CONTENT_TOO_LARGE` | Over your plan's per-version cap. `limit_bytes` says how much. |
| `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. |