---
title: "Client's note on one item"
method: PUT
path: "/portal/{slug}/items/{key}/note"
tags: ["Portal"]
---

# Client's note on one item

`PUT /portal/{slug}/items/{key}/note`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/portal/{slug}/items/{key}/note`
- Auth: none required

As with the job-level note, visible to both sides. The owner's own note on the same item is never returned here.

## Path parameters

- `slug` string, required
- `key` string, required

## Request body

- object
  - `note` string, nullable, required

## Response `200`

Saved

## Other responses

- `401`: No valid portal session
- `404`: Resource not found
- `422`: Validation error — the body shape is correct but values are invalid

---

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