---
title: "Create a synced copy of an item"
method: POST
path: "/api/v1/items/{sourceItemId}/synced-copy"
tags: ["Items"]
---

# Create a synced copy of an item

`POST /api/v1/items/{sourceItemId}/synced-copy`

Which properties are synced (title, assignees, tags, child items, etc.) is controlled by the
workspace's sync configuration and cannot be overridden per request.
Returns 400 if the source item already has a synced copy in any workspace.

## Path parameters

- `sourceItemId` string, uuid, required

## Request body

- ExternalAPIContractsRequestsV1AddSyncedCopyRequest
  - `requestId` string, uuid, nullable — Idempotency key
  - `boardId` string, uuid, required — ID of the board to place the synced copy on.
  - `rowId` string, uuid, required — ID of the row (swimlane) on the target board.

## Response `200`

OK

- ExternalAPIContractsResponsesV1EntitiesItem
  - `id` string, uuid, required
  - `displayId` string, nullable, required
  - `workspaceId` string, uuid, required
  - `boardId` string, uuid, nullable
  - `rowId` string, uuid, required
  - `title` string, nullable, required
  - `statusId` string, uuid, nullable
  - `ownerId` string, uuid, nullable
  - `assignedUserId` string, uuid, nullable
  - `color` integer, required
  - `startDate` string, date-time, nullable
  - `dueDate` string, date-time, nullable
  - `isScheduleLocked` boolean, required
  - `completedOn` string, date-time, nullable
  - `description` string, nullable
  - `budget` number, double, nullable
  - `estimation` number, double, nullable
  - `estimationType` string, nullable, required
  - `completed` boolean, required
  - `archived` boolean, required
  - `modifiedDate` string, date-time, required
  - `createdDate` string, date-time, required
  - `archivedDate` string, date-time, nullable
  - `totalLoggedTime` integer, required
  - `milestone` boolean, required
  - `progress` integer, nullable
  - `isSuspended` boolean, required
  - `suspendReason` string, nullable, required
  - `parentId` string, uuid, nullable
  - `tags` string[], nullable, required
  - `customFields` ExternalAPIContractsResponsesV1EntitiesCustomField[], nullable, required
    - `name` string, nullable, required
    - `value` string, nullable, required
  - `relations` ExternalAPIContractsResponsesV1EntitiesItemRelations, required
    - `children` string[], nullable, required
    - `waiting` string[], nullable, required
    - `blocking` string[], nullable, required
    - `syncCopies` string[], nullable, required
    - `waitingDependencyDirections` ExternalAPIContractsResponsesV1EntitiesDependencyDirection[], nullable, required
      - `itemId` string, uuid, required
      - `direction` string, nullable, required
    - `blockingDependencyDirections` ExternalAPIContractsResponsesV1EntitiesDependencyDirection[], nullable, required
      - `itemId` string, uuid, required
      - `direction` string, nullable, required
  - `aggregates` ExternalAPIContractsResponsesV1EntitiesItemAggregates, required
    - `budget` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemDecimalSystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` number, double, required
    - `estimation` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemDecimalSystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` number, double, required
    - `totalLoggedTime` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemInt32SystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` integer, required
    - `startDate` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemDateTimeSystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` string, date-time, required
    - `dueDate` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemDateTimeSystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` string, date-time, required
    - `duration` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemInt32SystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` integer, required
    - `progress` ExternalAPIContractsResponsesV1EntitiesAggregateValue1SystemInt32SystemPrivateCoreLibVersion8000CultureNeutralPublicKeyToken7cec85d7bea7798e, required
      - `value` integer, required
    - `customFields` ExternalAPIContractsResponsesV1EntitiesCustomField[], nullable, required
      - `name` string, nullable, required
      - `value` string, nullable, required
  - `url` string, nullable, required
  - `hasAttachments` boolean, required
  - `duration` integer, nullable
  - `sortOrder` integer, required
  - `parentRelativeSortOrder` integer, nullable
  - `baselines` ExternalAPIContractsResponsesV1EntitiesBaseline[], nullable, required
    - `startDate` string, date-time, nullable
    - `dueDate` string, date-time, nullable
    - `estimation` number, double, nullable
    - `budget` number, double, nullable
    - `duration` integer, nullable

---

[API](https://skmtc.net/teamhood/apis/teamhood-api-v1.md) · [All operations](https://skmtc.net/teamhood/apis/teamhood-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teamhood/teamhood-api-v1/versions/85a10c67381d/schema)