Update an employee
curl --request PATCH \
--url https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": true,
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}
'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id}"
payload = {
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": True,
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
start_date: '2023-12-25',
details: {},
active: true,
external_id: '<string>',
tax_id: '<string>',
social_security_number: '<string>',
birth_date: '2023-12-25',
employment: {
contribution_account: '<string>',
contract_type: '<string>',
working_time_coefficient: 500,
contribution_group: 6,
occupation_code: '<string>',
collective_agreement: '<string>'
}
})
};
fetch('https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}{
"error": "lines[0].vat_rate must be 21, 10, 4 or 0",
"code": "invalid_invoice",
"request_id": "req_01JAB3K9X2"
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}Employees
Update an employee
Changes the fields you send.
PATCH
/
companies
/
{company_id}
/
employees
/
{employee_id}
Update an employee
curl --request PATCH \
--url https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": true,
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}
'import requests
url = "https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id}"
payload = {
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": True,
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
start_date: '2023-12-25',
details: {},
active: true,
external_id: '<string>',
tax_id: '<string>',
social_security_number: '<string>',
birth_date: '2023-12-25',
employment: {
contribution_account: '<string>',
contract_type: '<string>',
working_time_coefficient: 500,
contribution_group: 6,
occupation_code: '<string>',
collective_agreement: '<string>'
}
})
};
fetch('https://api.melso.ai/v1/companies/{company_id}/employees/{employee_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"start_date": "2023-12-25",
"details": {},
"active": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"tax_id": "<string>",
"social_security_number": "<string>",
"birth_date": "2023-12-25",
"employment": {
"contribution_account": "<string>",
"contract_type": "<string>",
"working_time_coefficient": 500,
"contribution_group": 6,
"occupation_code": "<string>",
"collective_agreement": "<string>"
}
}{
"error": "lines[0].vat_rate must be 21, 10, 4 or 0",
"code": "invalid_invoice",
"request_id": "req_01JAB3K9X2"
}{
"error": "invalid token",
"code": "unauthorized",
"request_id": "req_01JAB3K9X2"
}{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}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
Your partner secret key, mk_live_… for real companies or mk_test_…
for test companies. Keep it on your servers. See
Authentication.
Path Parameters
The company's ID. Every company-scoped call works in exactly this company.
Body
application/json
Maximum string length:
200Replaces the whole object.
Preview.
Preview.
Preview.
Preview.
Preview. What the TGSS and the SEPE need about the job.
Show child attributes
Show child attributes
Response
The updated employee.
Preview.
Preview.
Preview.
Preview.
Preview. What the TGSS and the SEPE need about the job.
Show child attributes
Show child attributes