kythene.v1.KytheneService

UpdatePage

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

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

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

wikistring

wiki is the wiki the page is in - its id or slug.

pagestring

page is the page's id or its full path within the wiki.

bodystring

body is the new markdown, in full - this replaces the page, it does not append to it.

baseRevisioninteger

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.

titlestring

title optionally retitles the page.

notestring

note is a short line about what changed - it shows on the page's history.

spacestring

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

Success

revisioninteger

revision is the new revision. Pass it as base_revision on your next write.

statestring

state is the page's state after the write.

urlstring

url is the page's canonical link - hand THAT to a person, never the bare id.

Changes

No recorded changes to this operation across all 1 revision of this API.