---
title: "Create a shared note in a project"
method: POST
path: "/projects/{project_id}/notes"
tags: ["project-notes"]
---

# Create a shared note in a project

`POST /projects/{project_id}/notes`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/projects/{project_id}/notes`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Request body

- CreateProjectNoteDto
  - `title` string, required
  - `is_private` boolean: True keeps the note visible only to its author. Omitted creates a shared note.
  - `content` object: TipTap/ProseMirror document JSON. Optional — a note can start empty.
  - `tags` CreateNoteTagDto[]: Tags as personal notes take them: an existing tag of this project by id, or a new one by text.
    - `text` string, required
    - `id` string, uuid
    - `color` string

## Response `201`

- ProjectNoteResponseDto
  - `id` string, required
  - `project_id` string, required
  - `created_by` string
  - `title` string, required
  - `content` object, nullable: TipTap/ProseMirror document JSON. Present on single-note responses; omitted from list responses (which only return metadata).
  - `is_private` boolean, required: True when only the author (`created_by`) can see the note. Only the author may change it.
  - `archived_at` string, date-time, nullable: Set while the note is archived (filed away, still readable); null when active.
  - `pinned_at` string, date-time, nullable: When the requesting user pinned the note; null when they haven't. Pins are per user.
  - `created_at` string
  - `updated_at` string
  - `tags` ProjectNoteTagResponseDto[], required: The note's tags, in the same shape as a personal note's.
    - `id` string, required
    - `text` string, required
    - `color` string

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)