---
title: "Update a company"
method: PATCH
path: "/companies/{id}"
tags: ["Companies"]
---

# Update a company

`PATCH /companies/{id}`

## Request

- Base URL: `https://www.ruddr.io/api/workspace`
- URL: `https://www.ruddr.io/api/workspace/companies/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string: The name of the company. Max 255 characters.
  - `isActive` boolean: Whether the company is active.
  - `description` string: A description of the company. Max 5000 characters.
  - `billingAddress` string: The billing address of the company. Max 5000 characters.
  - `currency` string: The three-letter currency code for the company.
  - `facebookUrl` string: The company's Facebook URL. Max 1024 characters.
  - `linkedinUrl` string: The company's LinkedIn URL. Max 1024 characters.
  - `twitterUrl` string: The company's Twitter URL. Max 1024 characters.
  - `websiteUrl` string: The company's website URL. Max 1024 characters.
  - `numberOfEmployees` integer: The number of employees.
  - `ownershipClass` 'public' | 'private' | 'subsidiary' | 'other' | 'null', nullable: The ownership class. Can be: `"public"` (Public), `"private"` (Private), `"subsidiary"` (Subsidiary), or `"other"` (Other).
  - `phoneNumber` string: The phone number of the company. Max 255 characters.
  - `revenue` number: The annual revenue of the company.
  - `shippingAddress` string: The shipping address of the company. Max 5000 characters.
  - `tickerSymbol` string: The stock ticker symbol for the company. Max 10 characters.
  - `yearFounded` integer: The year the company was founded.
  - `companySpendTierId` string: The company spend tier ID (`uuid`) of the company spend tier associated with this company.
  - `companyTypeId` string: The company type ID (`uuid`) of the company type associated with this company.
  - `practiceId` string: The practice ID (`uuid`) of the practice associated with this company.
  - `businessUnitId` string, nullable: The business unit ID (`uuid`) of the business unit associated with this company.
  - `industryId` string: The industry ID (`uuid`) of the industry associated with this company.
  - `ownerId` string: The member ID (`uuid`) of the owner of this company.
  - `sicCodeId` string: The SIC code ID (`uuid`) of the SIC code associated with this company.
  - `timeZoneId` string: The time zone ID (`uuid`) of the time zone associated with this company.

## Response `200`

200

- Company
  - `id` string: The unique identifier for the object.
  - `name` string, nullable: The name of the company.
  - `isActive` boolean: Whether the company is active.
  - `description` string, nullable: A description of the company.
  - `billingAddress` string, nullable: The billing address of the company.
  - `currency` string: The three-letter currency code for the company.
  - `facebookUrl` string, nullable: The company's Facebook URL.
  - `linkedinUrl` string, nullable: The company's LinkedIn URL.
  - `twitterUrl` string, nullable: The company's Twitter URL.
  - `websiteUrl` string, nullable: The company's website URL.
  - `numberOfEmployees` integer, nullable: The number of employees.
  - `ownershipClass` 'public' | 'private' | 'subsidiary' | 'other' | 'null', nullable: The ownership classification of the company.
  - `phoneNumber` string, nullable: The phone number of the company.
  - `revenue` number, nullable: The annual revenue of the company.
  - `shippingAddress` string, nullable: The shipping address of the company.
  - `tickerSymbol` string, nullable: The stock ticker symbol for the company.
  - `yearFounded` integer, nullable: The year the company was founded.
  - `createdAt` string, date-time: The timestamp when the object was created.
  - `modifiedAt` string, date-time: The timestamp when the object was last modified.
  - `companySpendTier` object, nullable: The company spend tier associated with this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the company spend tier.
  - `companyType` object, nullable: The company type associated with this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the company type.
  - `practice` object, nullable: The practice associated with this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the practice.
  - `businessUnit` object, nullable: The business unit associated with this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the business unit.
  - `industry` object, nullable: The industry associated with this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the industry.
  - `owner` object, nullable: The workspace member who owns this company.
    - `id` string: The unique identifier for the object.
    - `name` string: The name of the owner member.
  - `sicCode` object, nullable: The Standard Industrial Classification (SIC) code associated with this company.
    - `id` string: The unique identifier for the object.
    - `code` string: The SIC code value.
    - `industryTitle` string: The industry title associated with the SIC code.
  - `salesforceId` string, nullable: The Salesforce record ID for this company, if synced via Salesforce integration.
  - `hubspotId` string, nullable: The HubSpot record ID for this company, if synced via HubSpot integration.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404
- `409`: 409

---

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