---
title: "Add a versioned note to an authorized project or collection record"
method: POST
path: "/v1/workspace/notes"
---

# Add a versioned note to an authorized project or collection record

`POST /v1/workspace/notes`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/workspace/notes`
- Auth: API key in header `Authorization`

## Request body

- WorkspaceNoteAdd
  - `project_id` string, nullable
  - `collection_id` string, nullable
  - `record_id` string, nullable
  - `expected_version` integer, required
  - `id` string, required
  - `text` string, required

## Response `200`

Add a versioned note to an authorized project or collection record

- object
  - `data` WorkspaceNotes, required
    - `version` integer, required
    - `notes` WorkspaceNote[], required
      - `id` string, required
      - `text` string, required
      - `author` string, required
      - `authorId` string, required
      - `at` string, required
      - `createdAt` string, required
      - `resolved` boolean, required
      - `projectId` string, nullable
      - `resolvedBy` string, nullable
      - `resolvedAt` string, nullable

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)