Create A Page

POST

/pages

curl --request POST \
  --url https://markdawn.space/api/v1/pages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "Project notes", "markdown": "# Project notes\n\nStart writing here." }'

• Hosted Markdawn API
• Relative to the current Markdawn server.

Creates a page in the requested folder, or at the Markdawn root when parentId is omitted or null. You can include initial markdown in the request body.

Authorizations

• bearerToken
• browserSession

Request Body^required

Media typeapplication/json

object

title

string

parentId

Any of:

string

string

/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

null

null

icon

Any of:

string

string

null

null

markdown

string

Example

{
  "title": "Project notes",
  "markdown": "# Project notes\n\nStart writing here."
}

Responses

201

Created page metadata.

Media typeapplication/json

object

id

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

parentId

required

Any of:

string

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

null

null

title

required

string

icon

required

Any of:

string

string

null

null

cover

required

Any of:

object

object

type

required

string

value

required

Any of:

string

string

null

null

null

null

properties

required

Any of:

object

object

key

additional properties

null

null

ownerId

required

Any of:

string

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

null

null

permission

required

Any of:

string

string

Allowed values: view edit admin

null

null

createdAt

required

string

updatedAt

required

string

Example

{
  "permission": "view"
}

403

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

Example^generated

{
  "error": {
    "code": "example",
    "message": "example"
  }
}