POST
Sol·licitar una absència
Scope:
team:time-off.writehttps://api.holded.com/api/v2/employees/{employeeId}/time-offsCrea una nova sol·licitud d'absència, vacança o permís per a l'empleat indicat.
Paràmetres
Paràmetres de ruta
employeeId
stringobligatoriID de l'empleat (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
object
time_off_type_idstringrequired
Tipus d'absència (p. ex. vacances, baixa, permís)
start_datestring<date>required
Data d'inici de l'absència (ATOM, ISO 8601 amb zona horària)
end_datestring<date>required
Data de fi de l'absència (ATOM, ISO 8601 amb zona horària)
start_periodstring | nulloptional
Granularitat de mig dia: morning, afternoon, full_day o hourly
Enum:
morningafternoonfull_dayhourlyreasonstring | nulloptional
Motiu o observacions opcionals
start_hourstring | nulloptional
Hora d'inici per a tipus amb granularitat horària (HH:MM)
num_hoursnumber | nulloptional
Durada en hores. Múltiple de 0.5
Petició
python
import requests
url = "https://api.holded.com/api/v2/employees/507f1f77bcf86cd799439012/time-offs"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"time_off_type_id": "507f1f77bcf86cd799439013",
"start_date": "2026-06-01",
"end_date": "2026-06-05",
"start_period": "morning",
"reason": "string",
"start_hour": "09:00",
"num_hours": 4
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
json
{
"id": "507f1f77bcf86cd799439011"
}Respostes exitoses
201Absència creadaapplication/jsonobject
idstring
Respostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Empleat no trobatapplication/json422Dades d'absència no vàlidesapplication/json429Límit de sol·licituds exceditapplication/json