PUT
Actualitzar un empleat
Scope:
team:employees.writehttps://api.holded.com/api/v2/employees/{employeeId}Actualitza les dades d'un empleat existent.
Paràmetres
Paràmetres de ruta
employeeId
stringobligatoriID de l'empleat (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
object
namestring
Nom de l'empleat
last_namestring
Cognoms de l'empleat
emailstring<email>
Email principal de l'empleat
workplace_idstring | null
Identificador del centre de treball
phonestring | null
Número de telèfon
mobilestring | null
Número de mòbil
date_of_birthstring | null
Data de naixement
genderstring | null
Gènere
main_languagestring | null
Codi d'idioma principal
nationalitystring | null
Codi de nacionalitat
codestring | null
Codi intern de l'empleat
social_security_numberstring | null
Número de seguretat social
ibanstring | null
IBAN bancari
reporting_tostring | null
ID de l'empleat responsable
team_ids[]string[] | null
ID dels equips als quals pertany
Petició
python
import requests
url = "https://api.holded.com/api/v2/employees/{employeeId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"name": "string",
"last_name": "string",
"email": "user@example.com",
"workplace_id": "string",
"phone": "string",
"mobile": "string",
"date_of_birth": "string",
"gender": "string",
"main_language": "string",
"nationality": "string",
"code": "string",
"social_security_number": "string",
"iban": "string",
"reporting_to": "string",
"team_ids": [
"string"
]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
json
{
"id": "string"
}Respostes exitoses
200Empleat actualitzatapplication/jsonobject
idstring
Respostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Empleat no trobatapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json