---
title: "PUT /v1/companies/{id}"
method: PUT
path: "/v1/companies/{id}"
tags: ["Companies"]
---

# PUT /v1/companies/{id}

`PUT /v1/companies/{id}`

## Request

- Base URL: `https://api.relaticle.com`
- URL: `https://api.relaticle.com/v1/companies/{id}`
- Auth: HTTP bearer

## Request body

- object
  - `name` string: Must not be greater than 255 characters.
  - `account_owner_id` 'scribe-user-id', nullable
  - `custom_fields` object

## Response `200`

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `name` string
      - `account_owner_id` string
      - `creation_source` string
      - `created_at` string
      - `updated_at` string
      - `custom_fields` object

## Other responses

- `401`: Missing or invalid access token.
- `402`: Relaticle Cloud only: the workspace is paused until it has an active subscription. The body carries an `upgrade_url`.
- `403`: The token lacks the `update` ability, or its user no longer belongs to the token's workspace.
- `404`: No record with that ID exists in the workspace.
- `422`: Validation failed.
- `429`: Rate limit exceeded. Back off for the number of seconds in `Retry-After`.

---

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