Skip to main content
PATCH
/
companies
/
{companyId}
/
employees
/
{employeeId}
Update employee
curl --request PATCH \
  --url https://pre-public-api.cobee.io/api/v3/companies/{companyId}/employees/{employeeId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "john.smith.updated@example.com",
  "name": "John",
  "surname": "Smith",
  "birthDate": "1985-07-15",
  "grossSalary": {
    "amountInCents": 4500000,
    "currency": "EUR"
  },
  "hiringDate": "2023-01-10",
  "taxRegime": "general",
  "workdayConfiguration": {
    "daysPerMonth": 22,
    "workTimePercentage": 100,
    "numberOfPaychecks": 14,
    "collectiveAgreementSalary": {
      "amountInCents": 3800000,
      "currency": "EUR"
    }
  },
  "internalId": "EMP-1234",
  "costCenter": "Finance",
  "payrollCompany": "Main Branch",
  "metadata": {
    "department": "Finance",
    "manager": "Jane Doe",
    "office": "Madrid"
  }
}'
This response does not have an example.
This endpoint allows you to update an existing employee’s information in the Cobee system. All fields in the request body are optional, so you only need to include the fields you want to update.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
companyId
string<uuid>
required

The unique identifier of the company

​
employeeId
string<uuid>
required

The unique identifier of the employee

Body

application/json

Employee data to be updated

​
email
string<email>

The employee's email address

​
legalId
string

The employee's legal identifier

​
name
string

The employee's first name

​
surname
string

The employee's surname

​
birthDate
string<date>

The employee's date of birth in ISO 8601 format (YYYY-MM-DD)

​
grossSalary
object

The employee's gross salary details

Example:
{
  "amountInCents": 4500000,
  "currency": "EUR"
}
​
hiringDate
string<date>

The date when the employee was hired in ISO 8601 format (YYYY-MM-DD)

​
taxRegime
enum<string>

The employee's tax regime

Available options:
general,
basque,
navarrese,
biscayan
​
workdayConfiguration
object

Configuration of the employee's workday

Example:
{
  "daysPerMonth": 22,
  "workTimePercentage": 100,
  "numberOfPaychecks": 14,
  "collectiveAgreementSalary": {
    "amountInCents": 3800000,
    "currency": "EUR"
  }
}
​
internalId
string

Your internal identifier for the employee

​
costCenter
string

The cost centre associated with this employee

​
payrollCompany
string

The company handling the employee's payroll, if different from the main company

​
metadata
object

Additional metadata for the employee (key-value pairs)

​
ssoInternalId
string

The Single Sign-On internal identifier for the employee

Response

Employee successfully updated