# Copy a board or a page into a new board

Duplicates a custom board or a pack page (leads, deals…) into a NEW board in ONE call — the way to answer "make a copy of X", "a new board with the same columns as X", or "copy X and bring its rows across". Body: `from` (a board id, or a page key such as leads), `name` for the new board, an optional `purpose` (defaults to the source board's), and `rows` (default true: every row you can read comes across; false copies the columns alone). Columns keep their label, kind, config and choices, in order; a page's status column becomes a select carrying the page's statuses. Rows go through the ordinary row writer, so formula and lookup cells recompute on the copy; file cells do NOT come across (files stay with the source's rows), and a person cell naming someone outside the workspace is left empty — both are listed in `skipped` with the reason. Answers 201 with the new `board`, `counts` {columns, rowsCopied, rowsSkipped} and `skipped`. A board or page you cannot read is a 404. At most 5000 rows — more is 413 `too_many_rows`. Never build a copy from post_boards followed by post_boards_import: an import carries only the rows it is sent, and one with none is refused.

Access class: `workspace`.

## Endpoint

`POST /v1/boards/copy`

## Request body

Content type: `application/json`.

```json
{
  "from": "string",
  "name": "string",
  "purpose": "string",
  "rows": true
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "board": {
      "access": "string",
      "canShare": true,
      "columns": [
        {
          "calculation": "string",
          "config": {
            "bands": [
              {
                "tone": "string",
                "upTo": 1.5
              }
            ],
            "definitionKey": "string",
            "object": "string"
          },
          "id": "",
          "kind": "string",
          "label": "string",
          "options": [
            {
              "groupLabel": "string",
              "id": "",
              "label": "string",
              "position": 1.5,
              "tone": "string",
              "value": "string"
            }
          ],
          "position": 1.5,
          "starred": true
        }
      ],
      "createdAt": "2026-01-01T00:00:00Z",
      "definitionKey": "string",
      "id": "",
      "name": "string",
      "purpose": "string",
      "rowCount": 1,
      "rows": [
        "string"
      ],
      "updatedAt": "2026-01-01T00:00:00Z",
      "view": "string"
    },
    "counts": {
      "columns": 1.5,
      "rowsCopied": 1.5,
      "rowsSkipped": 1.5
    },
    "skipped": [
      "string"
    ]
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
