# Company API

The Company API provides endpoints for managing company master data, configurations, and features.

Version: 1.0

## Servers

Development server
```
https://k8s-exp-api-dev.hunty.cloud
```

Production server
```
https://k8s-exp-api-stg.hunty.cloud
```

## Security

### bearer

Type: http
Scheme: bearer
Bearer Format: JWT

### x-auth-api-key

Type: apiKey
In: header
Name: x-auth-api-key

## Download OpenAPI description

 - [Company API](https://docs.hunty.cloud/_bundle/apis/company/index.yaml)

## Company Data Source

 - [POST /companies/{companyId}/data-sources](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_create.md): Creates a single LIST or NUMERIC DataSource for a company.
 - [GET /companies/{companyId}/data-sources](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_getbycompanyid.md): Returns every DataSource (LIST + NUMERIC mixed) belonging to the company.
 - [PATCH /companies/{companyId}/data-sources/{id}](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_update.md): Partial update of the DataSource's own fields, polymorphic by `type`. Never mutates items — use the dedicated items endpoints for that.
 - [GET /companies/{companyId}/data-sources/{id}](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_getbyid.md): Returns items with their full state (active + disabled).
 - [POST /companies/{companyId}/data-sources/{id}/items](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_additems.md): Batch add, all-or-nothing. Fails if any item collides on name or refCode, either with an existing active item or with another item in the same batch.
 - [PATCH /companies/{companyId}/data-sources/{id}/items](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_updateitems.md): Batch edit by item id, all-or-nothing. Fails if any id does not exist or any edit collides on name/refCode with another active item. Cannot create or disable items here.
 - [PATCH /companies/{companyId}/data-sources/{id}/items/disable](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_disableitems.md): Batch disable, all-or-nothing. At least one active item must remain.
 - [PATCH /companies/{companyId}/data-sources/{id}/items/enable](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_enableitems.md): Batch enable. Fails if any item collides on refCode with a currently active item.
 - [POST /companies/{companyId}/data-sources/massive](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_createmany.md): Heterogeneous batch (LIST + NUMERIC mixed). Idempotent by name — existing names are skipped, not errored.
 - [POST /companies/{companyId}/data-sources/{id}/items/import/preview](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_previewimportitems.md): Validates every row, returns full parsed data + an observation per row that cannot be created. Nothing is persisted.
 - [POST /companies/{companyId}/data-sources/{id}/items/import](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_importitems.md): Re-validates the uploaded file from scratch and commits. All-or-nothing. Rows matching an existing active item are skipped, not updated.
 - [GET /companies/{companyId}/data-sources/{id}/items/import-template](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_downloadimporttemplate.md): Downloads a blank csv/xlsx with localized headers.
 - [PATCH /companies/{companyId}/data-sources/{id}/enable](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_enable.md): Enable a disabled DataSource.
 - [PATCH /companies/{companyId}/data-sources/{id}/disable](https://docs.hunty.cloud/apis/company/company-data-source/companydatasourcecontroller_disable.md): Disable an enabled DataSource.
## Company Feature

 - [GET /companies/features/company/{companyId}](https://docs.hunty.cloud/apis/company/company-feature/companyfeaturecontroller_getcompanyfeatures.md): Retrieves a list of company features.
## Company Master Area

 - [GET /companies/{companyId}/masters/areas](https://docs.hunty.cloud/apis/company/company-master-area/companymasterareacontroller_get.md): Returns a paginated list of master areas for a company.
 - [POST /companies/{companyId}/masters/areas](https://docs.hunty.cloud/apis/company/company-master-area/companymasterareacontroller_create.md): Creates a new master area for a company.
 - [POST /companies/{companyId}/masters/areas/massive](https://docs.hunty.cloud/apis/company/company-master-area/companymasterareacontroller_createmany.md): Creates multiple master areas for a company.
 - [PATCH /companies/{companyId}/masters/areas/{areaId}](https://docs.hunty.cloud/apis/company/company-master-area/companymasterareacontroller_update.md): Updates an existing master area for a company.
## Company Master Source

 - [GET /companies/{companyId}/masters/sources](https://docs.hunty.cloud/apis/company/company-master-source/companymastersourcecontroller_get.md): Returns a paginated list of master sources for a company.
 - [POST /companies/{companyId}/masters/sources](https://docs.hunty.cloud/apis/company/company-master-source/companymastersourcecontroller_create.md): Creates a new master source for a company.
 - [POST /companies/{companyId}/masters/sources/massive](https://docs.hunty.cloud/apis/company/company-master-source/companymastersourcecontroller_createmany.md): Creates multiple master sources for a company.
 - [PATCH /companies/{companyId}/masters/sources/{sourceId}](https://docs.hunty.cloud/apis/company/company-master-source/companymastersourcecontroller_update.md): Updates an existing master source for a company.
## Company Master Vacancy Tag

 - [GET /companies/{companyId}/masters/vacancy-tags](https://docs.hunty.cloud/apis/company/company-master-vacancy-tag/companymastervacancytagcontroller_get.md): Returns a paginated list of master vacancy tags for a company.
 - [POST /companies/{companyId}/masters/vacancy-tags](https://docs.hunty.cloud/apis/company/company-master-vacancy-tag/companymastervacancytagcontroller_create.md): Creates a new master vacancy tag for a company.
 - [POST /companies/{companyId}/masters/vacancy-tags/massive](https://docs.hunty.cloud/apis/company/company-master-vacancy-tag/companymastervacancytagcontroller_createmany.md): Creates multiple master vacancy tags for a company.
 - [PATCH /companies/{companyId}/masters/vacancy-tags/{vacancyTagId}](https://docs.hunty.cloud/apis/company/company-master-vacancy-tag/companymastervacancytagcontroller_update.md): Updates an existing master vacancy tag for a company.