---
title: "Update a Company"
method: PUT
path: "/v1/company"
tags: ["Companies"]
---

# Update a Company

`PUT /v1/company`

Updates information about the specified company.

## Query parameters

- `isDuplicateBypassed` boolean

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- CompanyDTO
  - `id` integer — The identifier for the company.
  - `name` string, required — The name of the company.
  - `mainAddress` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `frontOfficeId` integer, required — The identifier for the company's home office/branch. It occupies the following position in the Front Office hierarchy: Division → Region → Office/Branch. Refer to the <a href="https://developer.avionte.com/reference/getbranches">Get Branches</a> endpoint to retrieve the ID.
  - `link` string — The website of the company.
  - `isArchived` boolean — An indication of whether the company record is archived or not.
  - `representativeUsers` integer[] — The IDs of the representatives who are working with the company.
  - `sourceName` string — The name of the company source.
  - `statusId` integer — The identifier for the company status.
  - `status` string — The status of the company. When a new status value is passed, the status is added to the tenant's list of custom company statuses, else we match on the string value to an existing company status.
  - `industry` string — The company industry.
  - `createdDate` string, date-time — The date the company profile was created. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `origin` string, required — The partner or vendor that originated the request.
  - `originRecordId` string — The identifier for the company that can be used to link the record within the originating system.
  - `department` DepartmentDTO
    - `compId` integer, required — The identifier for company.
    - `departmentName` string, required — The name of the department.
    - `officeId` integer — The identifier for the office.
    - `statusId` integer — The identifier for the status.
    - `parentDepartmentId` integer — The identifier for the parent department.
    - `street1` string — Street address line 1 for the department.
    - `street2` string — Street address line 2 for the department.
    - `city` string — City for the department.
    - `stateProvince` string, required — Province, state, or region for the department.
    - `postalCode` string — ZIP/postal code for the department.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the department country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
    - `geoCode` string — Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address.
    - `departmentPhone` string — Phone number of the branch.
    - `defaultJobOwnerIDs` integer[] — User IDs of the default job owners of the department.
    - `origin` string — The origin of the department.
    - `weekEndDate` string — Week End Date for the department. Allowed values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
    - `payPeriod` string — Pay Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `payCycle` string — Pay Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `billingPeriod` string — Billing Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `billingCycle` string — Billing Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `originRecordId` string — The identifier for the origin of the department from partner database.
  - `weekEndDay` string — The Week End Day of the company. Valid values are 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', and 'Sunday'.
  - `payPeriod` string — The Pay Period of the company. Valid values are 'Hourly', 'Daily', 'Weekly', 'BiWeekly', 'SemiMonthly', 'Monthly', and 'Yearly'.
  - `payCycle` string — The Pay Cycle of the company. Valid values are '1', '2', '3', '4', and 'Last Week'.
  - `billingPeriod` string — The Billing Period of the company. Valid values are 'Hourly', 'Daily', 'Weekly', 'BiWeekly', 'SemiMonthly', 'Monthly', and 'Yearly'.
  - `billingCycle` string — The Billing Cycle of the company. Valid values are '1', '2', '3', '4', and 'Last Week'.
  - `isParent` boolean — Indicates whether the company is a parent company.
  - `parentCompanyId` integer — The identifier for the parent company if this company is a child.
  - `phoneNumber` string — The phone number for the company.

## Response `201`

The updated company.

- CompanyDTO
  - `id` integer — The identifier for the company.
  - `name` string, required — The name of the company.
  - `mainAddress` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `frontOfficeId` integer, required — The identifier for the company's home office/branch. It occupies the following position in the Front Office hierarchy: Division → Region → Office/Branch. Refer to the <a href="https://developer.avionte.com/reference/getbranches">Get Branches</a> endpoint to retrieve the ID.
  - `link` string — The website of the company.
  - `isArchived` boolean — An indication of whether the company record is archived or not.
  - `representativeUsers` integer[] — The IDs of the representatives who are working with the company.
  - `sourceName` string — The name of the company source.
  - `statusId` integer — The identifier for the company status.
  - `status` string — The status of the company. When a new status value is passed, the status is added to the tenant's list of custom company statuses, else we match on the string value to an existing company status.
  - `industry` string — The company industry.
  - `createdDate` string, date-time — The date the company profile was created. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `origin` string, required — The partner or vendor that originated the request.
  - `originRecordId` string — The identifier for the company that can be used to link the record within the originating system.
  - `department` DepartmentDTO
    - `compId` integer, required — The identifier for company.
    - `departmentName` string, required — The name of the department.
    - `officeId` integer — The identifier for the office.
    - `statusId` integer — The identifier for the status.
    - `parentDepartmentId` integer — The identifier for the parent department.
    - `street1` string — Street address line 1 for the department.
    - `street2` string — Street address line 2 for the department.
    - `city` string — City for the department.
    - `stateProvince` string, required — Province, state, or region for the department.
    - `postalCode` string — ZIP/postal code for the department.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the department country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
    - `geoCode` string — Numerical coordinate. The value is generated based on the ZIP code, city, and state of the address.
    - `departmentPhone` string — Phone number of the branch.
    - `defaultJobOwnerIDs` integer[] — User IDs of the default job owners of the department.
    - `origin` string — The origin of the department.
    - `weekEndDate` string — Week End Date for the department. Allowed values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
    - `payPeriod` string — Pay Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `payCycle` string — Pay Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `billingPeriod` string — Billing Period for the department. Allowed values: Daily, Weekly, BiWeekly, Monthly, SemiMonthly, Yearly, Hourly.
    - `billingCycle` string — Billing Cycle for the department. Allowed values: 1, 2, 3, 4, Last Week.
    - `originRecordId` string — The identifier for the origin of the department from partner database.
  - `weekEndDay` string — The Week End Day of the company. Valid values are 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', and 'Sunday'.
  - `payPeriod` string — The Pay Period of the company. Valid values are 'Hourly', 'Daily', 'Weekly', 'BiWeekly', 'SemiMonthly', 'Monthly', and 'Yearly'.
  - `payCycle` string — The Pay Cycle of the company. Valid values are '1', '2', '3', '4', and 'Last Week'.
  - `billingPeriod` string — The Billing Period of the company. Valid values are 'Hourly', 'Daily', 'Weekly', 'BiWeekly', 'SemiMonthly', 'Monthly', and 'Yearly'.
  - `billingCycle` string — The Billing Cycle of the company. Valid values are '1', '2', '3', '4', and 'Last Week'.
  - `isParent` boolean — Indicates whether the company is a parent company.
  - `parentCompanyId` integer — The identifier for the parent company if this company is a child.
  - `phoneNumber` string — The phone number for the company.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `409` — Operation could not be completed due to conflict.
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/versions/846b33e4e71b/schema)