---
title: "Duplicate a document into the caller's files."
method: POST
path: "/documents/{id}/copy"
tags: ["Documents"]
---

# Duplicate a document into the caller's files.

`POST /documents/{id}/copy`

## Request

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

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string: At most 60 characters; a longer name is stored shortened at a word boundary with an ellipsis, and whitespace runs collapse to one space.

## Response `201`

Success.

- object
  - `document` Document, required
    - `communityState` 'listed' | 'hidden' | 'null', nullable
    - `createdAt` number, required
    - `folderId` string, nullable, required
    - `id` string, required
    - `itemTypes` ItemTypeCatalogue
      - `types` ItemTypeDef[], required
        - `color` string, required
        - `custom` CustomFieldDef[]
          - `currency` string
          - `id` string, required
          - `kind` 'text' | 'longtext' | 'number' | 'currency' | 'date' | 'checkbox' | 'link' | 'email' | 'choice' | 'multichoice' | 'rating' | 'card', required
          - `label` string, required
          - `linkType` string
          - `onCard` boolean
          - `options` string[]
          - `scale` number
        - `defaultStatus` string
        - `detailsLabel` string
        - `display` object
          - `compact` object
            - `body` CardField[]
              - …
            - `foot` CardField[]
              - …
            - `footEnd` CardField[]
              - …
            - `head` CardField[]
              - …
            - `headEnd` CardField[]
              - …
            - `lead` CardField[]
              - …
            - `row` CardField[]
              - …
            - `trail` CardField[]
              - …
          - `detailed` object
            - `body` CardField[]
              - …
            - `foot` CardField[]
              - …
            - `footEnd` CardField[]
              - …
            - `head` CardField[]
              - …
            - `headEnd` CardField[]
              - …
            - `lead` CardField[]
              - …
            - `row` CardField[]
              - …
            - `trail` CardField[]
              - …
          - `minimal` object
            - `body` CardField[]
              - …
            - `foot` CardField[]
              - …
            - `footEnd` CardField[]
              - …
            - `head` CardField[]
              - …
            - `headEnd` CardField[]
              - …
            - `lead` CardField[]
              - …
            - `row` CardField[]
              - …
            - `trail` CardField[]
              - …
        - `excludedStatuses` string[]
        - `fields` string[], required
        - `glyph` union, required
          - 'task' | 'story' | 'bug' | 'project' | 'action' | 'epic' | 'milestone' | 'release' | 'ticket' | 'kanban' | 'checklist' | 'inbox' | 'person' | 'team' | 'user-plus' | 'user-check' | 'contact' | 'crown' | 'chat' | 'mail' | 'phone' | 'megaphone' | 'bell' | 'send' | 'video' | 'at' | 'calendar' | 'flag' | 'clock' | 'target' | 'pin' | 'hourglass' | 'repeat' | 'note' | 'idea' | 'bookmark' | 'book' | 'document' | 'pencil' | 'lightbulb' | 'puzzle' | 'quote' | 'star' | 'heart' | 'risk' | 'shield' | 'lock' | 'eye' | 'fire' | 'sparkle' | 'info' | 'question' | 'ban' | 'trophy' | 'coin' | 'chart' | 'trend' | 'briefcase' | 'cart' | 'building' | 'percent' | 'wallet' | 'cube' | 'gift' | 'wrench' | 'code' | 'laptop' | 'database' | 'cloud' | 'globe' | 'home' | 'key' | 'leaf' | 'link'
          - 'item'
        - `id` string, required
        - `label` string, required
        - `newTitle` string, required
        - `tabs` ItemTypeTab[]
          - `fields` string[], required
          - `id` string, required
          - `label` string, required
      - `version` number, required
    - `itemTypesRev` number
    - `name` string, required
    - `opensIn` 'diagram' | 'draw' | 'workshop' | 'pages' | 'plan', required
    - `ownerColor` string, nullable, required
    - `ownerId` string, required
    - `ownerName` string, nullable, required
    - `presentation` string, nullable, required
    - `savedAt` number, required
    - `shareCode` string, nullable, required
    - `shareable` boolean, required
    - `source` 'ai' | 'mcp' | 'cli', required
    - `tabKind` 'diagram' | 'event-storming', required
    - `tabs` TabSummary[], required
      - `documentId` string, required
      - `folder` string
      - `id` string, required
      - `name` string, required
      - `orderIndex` number, required
      - `outOfScope` true
      - `updatedAt` number, required
    - `teamId` string, nullable, required
    - `templateFamily` 'retrospective' | 'kanban', required

## Other responses

- `401`: Error.
- `403`: Error.
- `404`: Error.
- `410`: Error.
- `429`: Rate limited. Back off and retry.

---

[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)