Fechas Importantes

Endpoints de la API pública para listar y crear fechas importantes (p. ej. ausencias, aniversarios). Todos requieren cabecera X-API-KEY. Solo GET listado, GET detalle y POST crear (sin PATCH ni DELETE).

Método	Endpoint	Descripción
GET	/v1/important-date/	Listar fechas importantes de un usuario (query por UUID de usuario)
GET	/v1/important-date/{important-date-uuid}/	Obtener una fecha importante por UUID
POST	/v1/important-date/	Crear una fecha importante

Listar Fechas Importantes

GET /v1/important-date/

Devuelve las fechas importantes de un usuario. Requiere el UUID del usuario como parámetro de consulta.

Parámetros de Consulta

Name	Type	Required	Description
`uuid`	string (UUID)	Required	UUID del usuario cuyas fechas devolver.

Petición

curl "https://api.dailybot.com/v1/important-date/?uuid=user-uuid-1" \
  -H "X-API-KEY: tu_api_key"

Response 200 OK

json

[
  {
    "uuid": "important-date-uuid",
    "user": {
      "uuid": "user-uuid",
      "full_name": "María García",
      "image": "...",
      "role": "MEMBER",
      "is_active": true
    },
    "name": "Vacación",
    "is_specific_date": false,
    "start_date": "2026-03-01",
    "end_date": "2026-03-10",
    "important_date_type": "time_off",
    "metadata": {}
  }
]

Response 404 Not Found (usuario no encontrado)

json

{
  "detail": "User does not exists",
  "code": "user_does_not_exists"
}

Obtener Fecha Importante

GET /v1/important-date/{important-date-uuid}/

Devuelve una fecha importante por UUID.

Petición

curl "https://api.dailybot.com/v1/important-date/important-date-uuid/" \
  -H "X-API-KEY: tu_api_key"

Response 200 OK

json

{
  "uuid": "important-date-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "María García",
    "image": "...",
    "role": "MEMBER",
    "is_active": true
  },
  "name": "Vacación",
  "is_specific_date": false,
  "start_date": "2026-03-01",
  "end_date": "2026-03-10",
  "important_date_type": "time_off",
  "metadata": {}
}

Response 404 Not Found

json

{
  "detail": "Important date does not exists",
  "code": "important_date_does_not_exists"
}

Crear Fecha Importante

POST /v1/important-date/

Crea una nueva fecha importante.

Parámetros del Cuerpo

Name	Type	Required	Description
`important_date_type`	string	Required	Tipo: time_off, birthday, anniversary, holiday, reminder, custom.
`name`	string	Required	Nombre o descripción (mín. 3 caracteres).
`start_date`	string	Required	Fecha inicio, YYYY-MM-DD.
`end_date`	string	Required	Fecha fin, YYYY-MM-DD.
`scope_user`	boolean	Optional	Si true, la fecha es para un usuario concreto; requiere user_uuid. Por defecto: false (toda la organización).
`user_uuid`	string (UUID)	Optional	UUID del usuario a asociar; requerido cuando scope_user es true.
`metadata`	object	Optional	Metadatos adicionales.

Petición

curl -X POST "https://api.dailybot.com/v1/important-date/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "important_date_type": "holiday",
    "name": "Fiesta del equipo",
    "start_date": "2026-12-25",
    "end_date": "2026-12-25",
    "metadata": {}
  }'

Response 200 OK

json

{
  "uuid": "important-date-uuid",
  "user": null,
  "name": "Team holiday",
  "is_specific_date": false,
  "start_date": "2026-12-25",
  "end_date": "2026-12-25",
  "important_date_type": "holiday",
  "metadata": {}
}

Response 404 Not Found (usuario no encontrado)

json

{
  "detail": "User does not exists",
  "code": "user_does_not_exists"
}