Update Default Availability Schedule

PATCH

schedules

default

curl --request PATCH \
  --url https://api.zeeg.me/v2/schedules/default \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "lena.meier@horizondigital.de"
}
'

{
  "success": true,
  "status": 200,
  "resource": {
    "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
    "uuid": "Q1ZYo391da",
    "email": "lena.meier@horizondigital.de",
    "title": "Working Hours",
    "isDefault": true,
    "timezone": "Europe/Berlin",
    "weeklyHours": [
      {
        "day": "Mon",
        "timesets": [
          [
            "09:00",
            "12:00"
          ],
          [
            "13:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Tue",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Wed",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Thu",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Fri",
        "timesets": [
          [
            "09:00",
            "15:00"
          ]
        ]
      },
      {
        "day": "Sat",
        "timesets": []
      },
      {
        "day": "Sun",
        "timesets": []
      }
    ],
    "specialHours": [
      {
        "date": "2026-04-21",
        "timesets": [
          [
            "10:00",
            "14:00"
          ]
        ]
      },
      {
        "date": "2026-04-25",
        "timesets": []
      }
    ],
    "timeOff": [
      {
        "uuid": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
        "uri": "https://api.zeeg.me/v2/time-off/3f2504e0-4f89-41d3-9a0c-0305e82c3301",
        "type": "vacation",
        "title": "Summer break",
        "startDate": "2026-08-01",
        "endDate": "2026-08-15",
        "startHalfDay": false,
        "endHalfDay": true,
        "startHalfDayCutoff": null,
        "endHalfDayCutoff": "13:00",
        "note": null
      }
    ],
    "currentTime": "2026-04-10T08:30:00+02:00",
    "createdAt": "2026-04-01T10:00:00.000000Z",
    "updatedAt": "2026-04-10T08:30:00.000000Z"
  }
}

{
  "message": "Unauthenticated."
}

{
  "error": {
    "type": "insufficient_scope",
    "message": "Your token is missing the required scope: schedules:write.",
    "error_id": "c51fecff-4ed2-4252-95ee-68efa06bc340",
    "required_scopes": [
      "schedules:write"
    ]
  }
}

{
  "message": "The timezone must be a valid timezone.",
  "errors": {
    "timezone": [
      "The timezone must be a valid timezone."
    ]
  }
}

Authorizations

Authorization

string

header

required

Body

application/json

string<email>

required

Email address of the user whose default schedule to update.

timezone

string | null

IANA timezone identifier. Set to null to keep the current timezone.

Example:

"Europe/Berlin"

weeklyHours

object[]

Weekly availability hours.

Hide child attributes

weeklyHours.day

enum<string>

The day of the week (e.g., "Mon").

Available options:

Mon,

Tue,

Wed,

Thu,

Fri,

Sat,

Sun

weeklyHours.timesets

string[][]

Time intervals for the day in HH:mm format as [start, end] tuples.

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

specialHours

object[]

Date-specific availability overrides.

Hide child attributes

specialHours.date

string<date>

The specific date (YYYY-MM-DD).

Example:

"2026-06-15"

specialHours.timesets

string[][] | null

Overrides for that date.

[] → date becomes unavailable
null → delete override and reset back to weekday availability

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

Response

success

boolean

required

status

integer

required

resource

object

required

Hide child attributes

resource.uri

string<uri>

API resource URI for this schedule

resource.uuid

string<uuid>

resource.email

string<email>

Email address of the schedule owner

resource.title

string

Display name of the schedule

resource.isDefault

boolean

Whether this is the default schedule

resource.timezone

string

IANA timezone identifier

resource.weeklyHours

object[]

Hide child attributes

resource.weeklyHours.day

string

Day of the week (3-letter).

resource.weeklyHours.timesets

string[][]

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

resource.specialHours

object[] | null

Hide child attributes

resource.specialHours.date

string<date>

resource.specialHours.timesets

string[][] | null

Required array length: 2 elements

Pattern: ^\d{2}:\d{2}$

resource.timeOff

object[]

User-level time-off periods (vacation, out-of-office) that apply across all of the user's scheduling pages. Only future periods are returned, ordered by start date. Half-day flags indicate the first/last day of the period is partial.

Hide child attributes

resource.timeOff.uuid

string<uuid>

resource.timeOff.uri

string<uri>

Canonical URL of the time-off period.

resource.timeOff.type

enum<string>

Available options:

vacation,

out_of_office

resource.timeOff.title

string | null

resource.timeOff.startDate

string<date>

resource.timeOff.endDate

string<date>

resource.timeOff.startHalfDay

boolean

resource.timeOff.endHalfDay

boolean

resource.timeOff.startHalfDayCutoff

string | null

Half-day cutoff (HH:MM), null when startHalfDay is false.

resource.timeOff.endHalfDayCutoff

string | null

Half-day cutoff (HH:MM), null when endHalfDay is false.

resource.timeOff.note

string | null

resource.currentTime

string

Current server time

resource.createdAt

string<date-time>

Timestamp of creation

resource.updatedAt

string<date-time>

Timestamp of last update

Last modified on April 29, 2026

Get Default Availability Schedule

Get Availability Schedule by UUID

curl --request PATCH \
  --url https://api.zeeg.me/v2/schedules/default \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "lena.meier@horizondigital.de"
}
'

{
  "success": true,
  "status": 200,
  "resource": {
    "uri": "https://api.zeeg.me/v2/schedules/Q1ZYo391da",
    "uuid": "Q1ZYo391da",
    "email": "lena.meier@horizondigital.de",
    "title": "Working Hours",
    "isDefault": true,
    "timezone": "Europe/Berlin",
    "weeklyHours": [
      {
        "day": "Mon",
        "timesets": [
          [
            "09:00",
            "12:00"
          ],
          [
            "13:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Tue",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Wed",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Thu",
        "timesets": [
          [
            "09:00",
            "17:00"
          ]
        ]
      },
      {
        "day": "Fri",
        "timesets": [
          [
            "09:00",
            "15:00"
          ]
        ]
      },
      {
        "day": "Sat",
        "timesets": []
      },
      {
        "day": "Sun",
        "timesets": []
      }
    ],
    "specialHours": [
      {
        "date": "2026-04-21",
        "timesets": [
          [
            "10:00",
            "14:00"
          ]
        ]
      },
      {
        "date": "2026-04-25",
        "timesets": []
      }
    ],
    "timeOff": [
      {
        "uuid": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
        "uri": "https://api.zeeg.me/v2/time-off/3f2504e0-4f89-41d3-9a0c-0305e82c3301",
        "type": "vacation",
        "title": "Summer break",
        "startDate": "2026-08-01",
        "endDate": "2026-08-15",
        "startHalfDay": false,
        "endHalfDay": true,
        "startHalfDayCutoff": null,
        "endHalfDayCutoff": "13:00",
        "note": null
      }
    ],
    "currentTime": "2026-04-10T08:30:00+02:00",
    "createdAt": "2026-04-01T10:00:00.000000Z",
    "updatedAt": "2026-04-10T08:30:00.000000Z"
  }
}

{
  "message": "Unauthenticated."
}

{
  "error": {
    "type": "insufficient_scope",
    "message": "Your token is missing the required scope: schedules:write.",
    "error_id": "c51fecff-4ed2-4252-95ee-68efa06bc340",
    "required_scopes": [
      "schedules:write"
    ]
  }
}

{
  "message": "The timezone must be a valid timezone.",
  "errors": {
    "timezone": [
      "The timezone must be a valid timezone."
    ]
  }
}