---
title: "Update a company's admin-managed fields (demo, client, parent)"
method: PATCH
path: "/api/admin/companies/{id}"
tags: ["Administration/Companies"]
---

# Update a company's admin-managed fields (demo, client, parent)

`PATCH /api/admin/companies/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `isDemoCompany` boolean
  - `isClientCompany` boolean
  - `parentId` string, nullable

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `isDemoCompany` number, nullable
    - `isRemoved` number, nullable
    - `isClientCompany` number, nullable
    - `parentId` string, nullable
    - `officialName` string, nullable
    - `displayName` string, nullable
    - `name` string, nullable
    - `transliteratedDisplayName` string, nullable
    - `transliteratedName` string, nullable
    - `transliteratedOfficialName` string, nullable
    - `officialNameLocalized` string, nullable
    - `internalCompanyCode` string, nullable
    - `notes` string, nullable
    - `facilityProcesses` string, nullable
    - `imageList` object[], nullable
      - `id` string, required
      - `url` string, required
      - `fileType` string
      - `originalUrl` string
    - `featuredImageFileId` string, nullable
    - `featuredImageFileUrl` string, nullable
    - `description` string, nullable
    - `country` string, nullable
    - `countryName` string, nullable
    - `city` string, nullable
    - `county` string, nullable
    - `zipCode` string, nullable
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `phone` string, nullable
    - `website` string, nullable
    - `geojson` object, nullable
      - `type` string, required
      - `geometry` object, required
        - `type` string, required
        - `coordinates` number[], required
    - `companySize` 'FROM_0_TO_1' | 'FROM_2_TO_10' | 'FROM_11_TO_50' | 'FROM_51_TO_200' | 'FROM_201_TO_500' | 'FROM_501_TO_1000' | 'FROM_1001_TO_5000' | 'FROM_5001_TO_10000' | 'FROM_10001_TO_INFINITE', nullable
    - `companyType` 'EDUCATIONAL_INSTITUTION' | 'GOVERNMENT_AGENCY' | 'NONPROFIT' | 'PARTNERSHIP' | 'PRIVATELY_HELD' | 'FAMILY_BUSINESS' | 'PUBLIC_COMPANY' | 'SELF_EMPLOYED' | 'SOLE_PROPRIETORSHIP', nullable
    - `videoFileId` string, nullable
    - `videoFileUrl` string, nullable
    - `numOfPermanentEmployees` number, nullable
    - `numOfMaleEmployees` number, nullable
    - `numOfFemaleEmployees` number, nullable
    - `commercialRegistrationNumber` string, nullable
    - `commercialRegisterNumber` string, nullable
    - `dunsNumber` string, nullable
    - `globalLocationNumber` string, nullable
    - `higgId` string, nullable
    - `manufacturerIdentificationCode` string, nullable
    - `osHubId` string, nullable
    - `slcpFacilityId` string, nullable
    - `textileExchangeId` string, nullable
    - `vatId` string, nullable
    - `workosOrganizationId` string, nullable
    - `zdhcId` string, nullable
    - `annualProductionCapacity` string, nullable
    - `annualProductionCapacityUnit` string, nullable
    - `minimumOrderQuantity` string, nullable
    - `minimumOrderQuantityPerStyle` string, nullable
    - `standardLeadTime` string, nullable
    - `createdAt` string, date-time, nullable
    - `createdByApiKeyId` string, nullable
    - `createdByApiKeyLabel` string, nullable
    - `createdByCompanyId` string, nullable
    - `createdByImpersonateId` string, nullable
    - `createdByUserId` string, nullable
    - `createdByUserName` string, nullable
    - `updatedAt` string, date-time, nullable
    - `updatedByApiKeyId` string, nullable
    - `updatedByApiKeyLabel` string, nullable
    - `updatedByCompanyId` string, nullable
    - `updatedByCompanyName` string, nullable
    - `updatedByImpersonateId` string, nullable
    - `updatedByImpersonateName` string, nullable
    - `updatedByUserId` string, nullable
    - `updatedByUserName` string, nullable
    - `videoFile` string, nullable
    - `collaborationStatus` string, nullable
    - `collaborationStartDate` string, date-time, nullable
    - `retracedRiskScore` string, nullable
    - `collaborationEndDate` string, date-time, nullable
    - `relationshipType` string, nullable
    - `relationshipTypeNames` string, nullable
    - `supplyChainTier` string, nullable
    - `responsiblePerson` string, nullable
    - `responsiblePersonNames` string, nullable
    - `vendors` string, nullable
    - `vendorsNames` string, nullable
    - `agents` string, nullable
    - `agentsNames` string, nullable

## Other responses

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

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 85 breaking, 19 warning, 85 info
  - request property `parentId` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `parentId` request property's minLength was increased from `0` to `1`
  - the response property `data/addressLine1` became nullable for the status `200`
  - the response property `data/addressLine2` became nullable for the status `200`
  - …185 more
- **2026-08-26** `b815f1f4e5bf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/companies/:id/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-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/97e51f27dc77/schema)