---
title: "Add a Note to a Sales Order Case"
method: POST
path: "/v2/sales-order-cases/{case_id}/notes"
tags: ["sales-order-cases"]
---

# Add a Note to a Sales Order Case

`POST /v2/sales-order-cases/{case_id}/notes`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/sales-order-cases/{case_id}/notes`
- Auth: HTTP bearer

Add a Note to a Sales Order Case

## Path parameters

- `case_id` string, required

## Request body

- CreateSalesOrderCaseNoteRequest
  - `text` string, required

## Response `200`

Successful Response

- SalesOrderCaseEventSchema
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `id` string, required
  - `case_id` string, required
  - `type` 'case_created' | 'case_updated' | 'case_resolved' | 'attention_requested' | 'email_sent' | 'email_replied' | 'call_completed' | 'call_scheduled' | 'sales_order_updated' | 'outreach_paused' | 'outreach_resumed' | 'note_added', required
  - `actor` 'system' | 'customer' | 'user', required
  - `occurred_at` string, date-time, required
  - `payload` object, required: Type-specific details. Links to other records use the foreign-key columns.
  - `summary` string, nullable, required: Review-written summary of the interaction, scrubbed of sensitive details.
  - `review_status` 'pending' | 'completed' | 'failed', required: Progress of the interaction review that fills in an event's `summary` and payload.
  - `call_id` string, nullable, required: The call, fetched through the calls endpoints.
  - `email_id` string, nullable, required: The email, fetched through the emails endpoints.
  - `user_id` string, nullable, required: The user who acted, for USER events.
  - `user_name` string, nullable, required: The acting user's full name, for `USER` events.
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

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