Skip to main content
PATCH
Update an employee
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
details replaces the whole object. Every change is kept in the employee’s history with who made it.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

employee_id
string<uuid>
required

Body

application/json
name
string
Maximum string length: 200
start_date
string<date>
details
object

Replaces the whole object.

active
boolean
external_id
string

Preview.

tax_id
string

Preview.

social_security_number
string

Preview.

birth_date
string<date>

Preview.

employment
object

Preview. What the TGSS and the SEPE need about the job.

Response

The updated employee.

id
string<uuid>
required
name
string
required
start_date
string<date>
required
details
object
required
active
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
external_id
string | null

Preview.

tax_id
string | null

Preview.

social_security_number
string | null

Preview.

birth_date
string<date> | null

Preview.

employment
object

Preview. What the TGSS and the SEPE need about the job.