v3

latestOpenAPI 3.0.0private2026-07-31264964.3 KB

Create a note

Create a note from markdown, html, or sliteml content, with a templateId or just an empty one. If no parentNoteId is specified, it will be created in your personal channel.

post/notes

Request body

titlestring required

Title of the note to create

parentNoteIdstring

Below which other note to create this note. If not specified, the note would be created in your personal channel

templateIdstring

If you want to apply a template to the created note

markdownstring blob
htmlstring
attributesstring[]

Attributes for the parent collection ordered by column. If they don't match the appropriate type, they would be ignored

slitemlstring

Response

Ok

reviewState'Verified' | 'Outdated' | 'VerificationRequested' | 'VerificationExpired'
archivedAtstring date-time nullable required

Date of the archiving of the note (null if not archived)

lastEditedAtstring date-time required

Date of the last edition of the note

updatedAtstring date-time required

Date of the last update of the note

createdAtstring date-time required

Date of the creation of the note

columnsstring[]

If note is in a collection, it will contain its column names

attributesstring[]

If note is in a collection, it will contain its attributes ordered by column

urlstring required

Url to the note

listPositionnumber double nullable

Position of the note among its siblings, matching the order shown in the Slite sidebar. Higher values come first (top of the sidebar). By default it is seeded from the creation date, so freshly created docs appear at the top; manual reordering overrides it. Combine with orderBy=listPosition_DESC on the children endpoint to reproduce the sidebar order. Null when the note has no explicit position.

parentNoteIdstring nullable required

Parent note id of the current note. It can be null if it's a root note.

iconColorstring nullable

Optional icon color for the note.

iconShapestring nullable

Optional icon identifier for the note.

titlestring required

Title of the note

idstring required

Id of the note