---
title: "Create or update a company"
method: PUT
path: "/companies/{companyId}"
tags: ["Company"]
---

# Create or update a company

`PUT /companies/{companyId}`

Create or update a company by its external `companyId` (upsert). Only `name`, `plan`, `domain`, `value`,
`sla`, `tags`, `address`, `customData` and the account owner (`owner` or `ownerEmail`) are accepted; any
other field is ignored. `tags` REPLACES the stored list (an empty array clears it), while `address` and
`customData` are merged into the existing values rather than replaced. `customData` accepts up to 100
primitive values, `tags` up to 50. Setting a non-empty `name` here marks it authoritative, so names sent
by the SDK will no longer overwrite it. `owner` is the id of a user in this project (`ownerEmail` their
email address); `null` or `""` clears it. An owner that is not a project member's id or email is ignored
(the rest of the update still applies), so check `owner` in the response.

## Path parameters

- `companyId` string, required

## Headers

- `project` string, required

## Request body

- unknown

## Changes

- **2026-09-24** `1d9061096608` — 4 info
  - added the optional property `allOf[subschema #2]/owner` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/ownerEmail` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/ownerSource` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/ownerUpdatedAt` to the response with the `200` status
- **2026-09-03** `490b7d6391f3` — 3 info
  - added the optional property `allOf[subschema #2]/websiteProfile` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/websiteProfileAt` to the response with the `200` status
  - added the required property `allOf[subschema #2]/tags` to the response with the `200` status
- **2026-07-26** `a37ec8862f96` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gleap/apis/gleap-server/changes/companies/:companyId/put.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) · [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/0a92e15c9803?raw)