Saltar al contingut principal
POST

Sol·licitar una absència

Scope:team:time-off.write
https://api.holded.com/api/v2/employees/{employeeId}/time-offs

Crea una nova sol·licitud d'absència, vacança o permís per a l'empleat indicat.

Paràmetres

Paràmetres de ruta

employeeIdstringobligatori

ID 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_dayhourly
reasonstring | 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/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
422Dades d'absència no vàlidesapplication/json
429Límit de sol·licituds exceditapplication/json