SLslite

Create a note

Changed on

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

  • Base URL
    https://api.slite.com/v1
  • Auth
    HTTP bearer

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, one per column in column order; null leaves a column unchanged and an empty string clears it. A value its column can't read, like "forty-two" for a number, an ambiguous "3/4/2026" for a date (pass YYYY-MM-DD) or "2,000" for a number (pass 2000 or 2.5), fails the request with a 400 collection-field-invalid-value naming the column, before anything is written.

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. Writable via the listPosition body parameter of the create and update endpoints.

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

Changes