---
title: "Créer une note"
method: POST
path: "/api/v1/notes"
tags: ["Notes"]
---

# Créer une note

`POST /api/v1/notes`

## Request

- Base URL: `https://lucidnest.test`
- URL: `https://lucidnest.test/api/v1/notes`
- Auth: HTTP bearer

Crée une nouvelle note. Si notebook_uuid n'est pas fourni, la note va dans l'inbox.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `title` string, nullable: Titre de la note.
  - `content` string, required: Contenu HTML de la note.
  - `notebook_uuid` string, nullable: UUID du cahier cible.
  - `is_pinned` boolean: Épingler la note.
  - `is_todo` boolean: Marquer comme tâche.
  - `todo_status` string, nullable: Statut de la tâche (pending, in_progress, done).
  - `todo_priority` string, nullable: Priorité (low, medium, high).
  - `todo_due_date` string, nullable: Must be a valid date.
  - `project_uuid` string, nullable: UUID du projet auquel rattacher la note.
  - `is_inbox` boolean: Force la note en boîte de réception. Sans effet si notebook_uuid est fourni.
  - `source_url` string, nullable: URL de la page capturée (extension Chrome).
  - `source_title` string, nullable: Titre de la page capturée (extension Chrome).
  - `external_ref` string, nullable: Référence fonctionnelle de l'intégration tierce (unicité durable par compte, ADR-007).

## Response `201`

- object
  - `data` object
    - `uuid` string
    - `title` string

## Other responses

- `409`
- `422`

---

[API](https://skmtc.dev/lucidnest/apis/lucidnest-api-documentation.md) · [All operations](https://skmtc.dev/lucidnest/apis/lucidnest-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/lucidnest/apis/lucidnest-api-documentation/revisions/38638944c947?raw)