> ## 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.
# Create or update by slug
> One call a scheduled job can repeat forever: creates the Page on the first run, adds a version on every run after.
The automation-friendly write. If a Page in your workspace holds this slug (or held it before a rename), the call adds a version to it. Otherwise it creates the Page under this slug. You never have to store a page id.
Needs a key with **Pages write** turned on. See [Scheduled and automated Pages](/pages/scheduled-pages) for the full recipe.
## Authorization
`Bearer mac_live_…`
## Path parameters
1 to 63 lowercase letters, digits and dashes. Anything else is `422 VALIDATION_FAILED`.
## Body
The full HTML document. Up to your plan's per-version cap (512 KB on Free).
Up to 150 characters. On create, without it we use the HTML ``, then "Untitled page". On update it renames the Page.
</ParamField>
<ParamField body="description" type="string | null">
Plain text, up to 300 characters. `null` clears it.
</ParamField>
<ParamField body="visibility" type="string">
`private` or `public`. Defaults to `private` on create. On update it changes the Page's visibility.
</ParamField>
<ParamField body="change_note" type="string">
Up to 500 characters, shown next to the version in the app.
</ParamField>
<ParamField body="conversation_id" type="string">
Link the Page to a conversation. Only used on create.
</ParamField>
<Note>
Every run applies the fields it sends and leaves the rest alone, so leave out `title` or `visibility` if someone manages them in the app. Otherwise the next run overwrites their change.
</Note>
## Response
`201 Created` when this call created the Page, `200 OK` when it updated one.
<ResponseField name="ok" type="boolean">
`true` on success.
</ResponseField>
<ResponseField name="created" type="boolean">
`true` when this call created the Page.
</ResponseField>
<ResponseField name="page" type="object">
The Page. Same fields as [Get a page](/api-reference/pages/get-page).
</ResponseField>
<ResponseField name="version" type="integer">
The version this call produced, or the current one when `deduplicated`.
</ResponseField>
<ResponseField name="url" type="string">
The Page's link: the members-only door for `private`, the Page itself for `public`.
</ResponseField>
<ResponseField name="version_url" type="string">
The permanent `/v/{n}` address of this version. For a private Page it sends members through the sign-in door first.
</ResponseField>
<ResponseField name="content_sha256" type="string">
SHA-256 of the stored content.
</ResponseField>
<ResponseField name="deduplicated" type="boolean">
`true` when the content was byte-for-byte identical to the current version, so nothing new was stored.
</ResponseField>
<RequestExample>
```bash curl theme={null}
curl -X PUT "https://app.my-aichatbot.com/api/v1/pages/by-slug/sales-report" \
-H "Authorization: Bearer $MAC_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Sales report",
"visibility": "private",
"content": "<!doctype html><html><head><title>SalesSales