---
title: "UpdatePage"
method: POST
path: "/kythene.v1.KytheneService/UpdatePage"
tags: ["kythene.v1.KytheneService"]
---

# UpdatePage

`POST /kythene.v1.KytheneService/UpdatePage`

## Request

- Base URL: `https://kythene.com` (the document declares no server; this is the origin it was published from)
- URL: `https://kythene.com/kythene.v1.KytheneService/UpdatePage`
- Auth: none required

UpdatePage replaces a page's body, taking a new snapshot. It REFUSES a
 write whose base revision has been superseded.

## Headers

- `Connect-Protocol-Version` 1, required: Define the version of the Connect protocol
- `Connect-Timeout-Ms` number: Define the timeout, in ms

## Request body

- KytheneV1UpdatePageRequest
  - `wiki` string: wiki is the wiki the page is in - its id or slug.
  - `page` string: page is the page's id or its full path within the wiki.
  - `body` string: body is the new markdown, in full - this replaces the page, it does not append to it.
  - `baseRevision` integer: base_revision is the revision you read before writing (from get_page). REQUIRED: if it is no longer current the write is refused, naming the newer one, so a second writer cannot silently overwrite the first.
  - `title` string: title optionally retitles the page.
  - `note` string: note is a short line about what changed - it shows on the page's history.
  - `space` string: space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

## Response `200`

Success

- KytheneV1UpdatePageResponse
  - `revision` integer: revision is the new revision. Pass it as base_revision on your next write.
  - `state` string: state is the page's state after the write.
  - `url` string: url is the page's canonical link - hand THAT to a person, never the bare id.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/kythene/apis/kythene-v1.md) · [All operations](https://skmtc.dev/kythene/apis/kythene-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/kythene/apis/kythene-v1/revisions/5a768e642d10?raw)