---
title: "PATCH /api/supplychain-mappings/reuse"
method: PATCH
path: "/api/supplychain-mappings/reuse"
tags: ["Company Chains"]
---

# PATCH /api/supplychain-mappings/reuse

`PATCH /api/supplychain-mappings/reuse`

Re-use a supply chain

## Request body

- object
  - `targetNodeId` string, required
  - `targetCollaborationId` string
  - `sourceCollaborationId` string, required
  - `removeRootNode` boolean

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `supplyChainId` string, required
    - `companyId` string, required
    - `supplyChainStatus` string, required
    - `collaborationType` string, required
    - `collaborationStatus` string, required
    - `invitedByCompanyId` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `createdByUserId` string, required
    - `updatedByUserId` string, required
    - `createdByCompanyId` string, required
    - `updatedByCompanyId` string, required
    - `collaboratingNodeId` string, required
    - `collaboratingSupplyChainName` string, required
    - `invitedByCompanyName` string
    - `message` string
    - `numberOfCollaborators` number
    - `numberOfMappedCompanies` number
    - `nodes` object[], required
      - `id` string, required
      - `parentId` string, nullable
      - `supplyChainId` string
      - `depth` number
      - `numberOfDescendants` number
      - `nodeType` 'root' | 'leaf' | 'intermediate' | 'parent', required
      - `companyId` string
      - `companyName` string
      - `retracedRiskScore` number
      - `country` string
      - `countryName` string
      - `imageList` unknown[]
        - unknown
      - `officialName` string
      - `displayName` string
      - `supplyChainTier` string[], nullable
      - `connectionType` string
      - `facilityProcesses` object[]
        - `facilityProcessId` string
        - `facilityProcessName` string
      - `canInvite` boolean
      - `isConnected` boolean
      - `reasonCode` string
      - `addedBy` string
      - `collaborationStatus` string, nullable
      - `lastNotifiedAt` string
      - `totalUsersCount` number
      - `activeUsersCount` number
      - `invitedUsersCount` number
      - `createdByCompanyId` string
      - `createdByCompanyName` string
      - `createdByUserId` string
      - `createdAt` string
      - `updatedByCompanyId` string
      - `updatedByCompanyName` string
      - `lastUpdated` string
    - `edges` object[], required
      - `originNodeId` string
      - `destinationNodeId` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-09-08** `556072aa583c` — 8 info
  - added the optional property `data/invitedByCompanyName` to the response with the `200` status
  - added the optional property `data/message` to the response with the `200` status
  - added the optional property `data/numberOfCollaborators` to the response with the `200` status
  - added the optional property `data/numberOfMappedCompanies` to the response with the `200` status
  - …4 more
- **2026-08-31** `97e51f27dc77` — 8 breaking, 8 info
  - the response property `data/collaboratingNodeId` became nullable for the status `200`
  - the response property `data/collaborationStatus` became nullable for the status `200`
  - the response property `data/collaborationType` became nullable for the status `200`
  - the response property `data/companyId` became nullable for the status `200`
  - …12 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/supplychain-mappings/reuse/patch.md)

---

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