---
title: "Update company-defined attributes"
method: PATCH
path: "/employees/{employee}/company_defined_attributes"
---

# Update company-defined attributes

`PATCH /employees/{employee}/company_defined_attributes`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/employees/{employee}/company_defined_attributes`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/employees/:employee/company_defined_attributes/patch.ts> (a function with typed inputs; its response is checked against the schema)

Returns an employee's company-defined attributes

## Path parameters

- `employee` string, required

## Request body

- object
  - `company_defined_attributes` object[]
    - `name` string, required: The attribute's unique identifier
    - `value` string, required
    - `effective_start` string, date

## Response `200`

200

- object
  - `company_defined_attributes` object[]
    - `label` string
    - `description` string
    - `name` string
    - `value` string
    - `options` unknown
    - `type` string
    - `effective_start` string

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/employees/:employee/company_defined_attributes/patch.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)