---
title: "Apply one action to a Q&A board element. Readers may add and vote; running the board needs edit access. The voter and author are derived from the caller, never read from the body. A guest's upvote answers 429 vote_limit once its network holds the most guest voters the document takes."
method: POST
path: "/documents/{id}/tabs/{tabId}/qa"
tags: ["Documents"]
---

# Apply one action to a Q&A board element. Readers may add and vote; running the board needs edit access. The voter and author are derived from the caller, never read from the body. A guest's upvote answers 429 vote_limit once its network holds the most guest voters the document takes.

`POST /documents/{id}/tabs/{tabId}/qa`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/documents/{id}/tabs/{tabId}/qa`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Owner-Id`

## Path parameters

- `id` string, required
- `tabId` string, required

## Request body

- object
  - `elementId` string, required
  - `action` object, required: One of: add { id, text, anonymous }; vote { noteId, on }; discuss { noteId | null }; done, reopen or remove { noteId }; clear.
    - `type` 'add' | 'vote' | 'discuss' | 'done' | 'reopen' | 'remove' | 'clear', required
    - `id` string
    - `text` string
    - `anonymous` boolean
    - `noteId` string, nullable
    - `on` boolean

## Response `200`

Success.

- object
  - `notes` QaNote[], required
    - `at` number, required
    - `author` object
      - `color` string, required
      - `name` string, required
    - `doneAt` number
    - `id` string, required
    - `state` 'discussing' | 'done'
    - `text` string, required
    - `voters` string[], required
  - `rev` integer, required
  - `voterId` string, required

## Other responses

- `400`: Error.
- `401`: Error.
- `403`: Error.
- `404`: Error.
- `409`: Error.
- `410`: Error.
- `413`: Error.
- `429`: Error.

---

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