Create note

Notes View as Markdown

POST/api/note

Creates a note in the current space.

Request body

namestring | nullRequired: Title of the note (1 to 255 characters).
parentIdinteger | nullRequired: ID of the parent note. Required: pass null to create a top-level note.
projectIdintegerRequired: ID of the project the note belongs to.
descriptionstring | null: Body of the note as Markdown (up to 1,000,000 characters). Defaults to an empty body.
isWipboolean | null: Marks the note as work in progress. Defaults to false.

Responses

200Note created
400Invalid request payload
401Authentication is required

Request

curl -X POST "https://<space>.repsona.com/api/note" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Meeting notes",
    "parentId": null,
    "projectId": 297
  }'

Example response

{
  "note": {
    "id": 191,
    "parentId": null,
    "projectId": 297,
    "spaceId": 631,
    "name": "Meeting notes",
    "sortOrder": null,
    "isWip": false,
    "createdAt": 1793662651363,
    "updatedAt": 1793662651363,
    "deletedAt": null,
    "tags": []
  },
  "siblings": []
}