---
title: "Add saves to a SaveHQ custom board"
method: POST
path: "/api/v1/actions/add_to_board"
tags: ["Change the board"]
---

# Add saves to a SaveHQ custom board

`POST /api/v1/actions/add_to_board`

## Request

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

Put saves on a custom board the user is on. The user's own saves go on as they are, not copied, and stay on their own board. Someone else's save the user can see (from friends_saves or a group chat) is a link, so it is saved to the user's board first and then added; undo removes that copy too. Everyone on the board sees them, private ones included, so this always needs the user's OK: the first call returns a preview naming who will see them, and a confirmToken.

Needs the person's OK: always.

## Request body

- object
  - `boardId` string, required: A custom board's id exactly as given to you.
  - `itemIds` string[], required: Save ids exactly as given to you.
  - `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)