Saltar al contingut principal
PUT

Actualitzar un empleat

Scope:team:employees.write
https://api.holded.com/api/v2/employees/{employeeId}

Actualitza les dades d'un empleat existent.

Paràmetres

Paràmetres de ruta

employeeIdstringobligatori

ID 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/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Empleat no trobatapplication/json
422Error de validacióapplication/json
429Límit de sol·licituds exceditapplication/json