Skip to content

Important Dates

Public API endpoints for listing and creating important dates (e.g. time off, anniversaries). All require X-API-KEY header. GET list, GET detail, and POST create only (no PATCH or DELETE).

Method Endpoint Description
GET /v1/important-date/ List important dates for a user (query by user UUID)
GET /v1/important-date/{important-date-uuid}/ Get a single important date by UUID
POST /v1/important-date/ Create an important date

List Important Dates

GET /v1/important-date/

Returns important dates for a user. Requires the user UUID as a query parameter.

Query Parameters

Name Type Required Description
uuid string (UUID) Required User UUID whose dates to return.
Request 
curl "https://api.dailybot.com/v1/important-date/?uuid=user-uuid-1" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
[
  {
    "uuid": "important-date-uuid",
    "user": {
      "uuid": "user-uuid",
      "full_name": "Jane Smith",
      "image": "...",
      "role": "MEMBER",
      "is_active": true
    },
    "name": "Vacation",
    "is_specific_date": false,
    "start_date": "2026-03-01",
    "end_date": "2026-03-10",
    "important_date_type": "time_off",
    "metadata": {}
  }
]
Response 404 Not Found (user not found)
json 
{
  "detail": "User does not exists",
  "code": "user_does_not_exists"
}

Get Important Date

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

Returns a single important date by UUID.

Request 
curl "https://api.dailybot.com/v1/important-date/important-date-uuid/" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
{
  "uuid": "important-date-uuid",
  "user": {
    "uuid": "user-uuid",
    "full_name": "Jane Smith",
    "image": "...",
    "role": "MEMBER",
    "is_active": true
  },
  "name": "Vacation",
  "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"
}

Create Important Date

POST /v1/important-date/

Creates a new important date.

Body Parameters

Name Type Required Description
important_date_type string Required Type: time_off, birthday, anniversary, holiday, reminder, custom.
name string Required Name or description (min 3 characters).
start_date string Required Start date, YYYY-MM-DD.
end_date string Required End date, YYYY-MM-DD.
scope_user boolean Optional If true, the date is for a specific user; requires user_uuid. Default: false (organization-wide).
user_uuid string (UUID) Optional User UUID to associate; required when scope_user is true.
metadata object Optional Additional metadata.
Request 
curl -X POST "https://api.dailybot.com/v1/important-date/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "important_date_type": "holiday",
    "name": "Team holiday",
    "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 (user not found)
json 
{
  "detail": "User does not exists",
  "code": "user_does_not_exists"
}