Replace Page Content
PUT
/pages/{pageId}/content
const url = 'https://markdawn.space/api/v1/pages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/content';const options = { method: 'PUT', headers: { 'If-Match': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'text/markdown' }, body: 'example'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://markdawn.space/api/v1/pages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/content \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: text/markdown' \ --header 'If-Match: example' \ --data exampleReplaces the complete markdown representation only when If-Match matches the current ETag. Read the page first, then reconcile and retry after a revision conflict.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”pageId
required
string format: uuid
The UUID of the page.
Header Parameters
Section titled “Header Parameters”If-Match
required
string
ETag returned when the current page content was read.
Request Bodyrequired
Section titled “Request Bodyrequired”Media typetext/markdown
string
Responses
Section titled “Responses”Page content replaced. The new ETag is returned in the response headers.
Headers
Section titled “Headers”ETag
string
Revision identifier for the returned page content.
The API token is missing a required scope: pages:write.
Media typeapplication/json
Structured error returned when the request cannot be completed.
object
error
required
Error details for programmatic handling.
object
code
required
Stable error code.
string
message
required
Human-readable explanation.
string
Examplegenerated
{ "error": { "code": "example", "message": "example" }}If-Match did not match the current page revision.
The If-Match header is required.