---
title: "Add a comment to a SaveHQ save"
method: POST
path: "/api/v1/actions/add_comment"
tags: ["Change the board"]
---

# Add a comment to a SaveHQ save

`POST /api/v1/actions/add_comment`

## Request

- Base URL: `https://savehq.app`
- URL: `https://savehq.app/api/v1/actions/add_comment`
- Auth: HTTP bearer

Add a note to one of the user's saves, or to any save on a custom board they're on. Notes start private (only the user sees them). public true shows it to everyone who can see the save; tag (person ids from get_save) lets those people read it and tells them in about 15 seconds. Either needs the user's OK: the first call returns a preview and a confirmToken.

Needs the person's OK: making it public.

## Request body

- object
  - `itemId` string, required
  - `text` string, required
  - `public` boolean
  - `tag` string[]: Person ids from get_save's “can tag” list.
  - `confirmToken` string: The confirmToken returned with this change's preview, once the user has agreed to it.

## Response `200`

Done (status "done", with summary and changeId), or nothing to change

- ChangeDone
  - `status` 'done' | 'no_change'
  - `summary` string
  - `changeId` string
  - `message` string

## Other responses

- `202`: Not done yet: needs the person's OK. Send the same request again with confirmToken.
- `400`: Something to fix in the request
- `401`: Missing, expired or revoked API key or token
- `429`: Over 60 requests a minute for this person; retry after 60 seconds

---

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