Skip to main content

Block staffer calendar

Method POST​

https://my.easyweek.io/api/public/v2/staffers/{staffer_uuid}/blocked-spots

Description: This endpoint blocks a time range on a staff member's calendar at a given location (e.g. a break or time off). Blocked ranges are excluded from time-slot search and booking. starts_at / ends_at are UTC and stored exactly as sent (no timezone shift).

note

To list staff, use Get Staffers (GET /locations/{location_uuid}/staffers).

Example Request​

curl -i -X POST \
  https://my.easyweek.io/api/public/v2/staffers/{staffer_uuid}/blocked-spots \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Request body​

{
  "location_uuid": "123b2980-3506-4f8c-abce-97e1ab653406",
  "starts_at": "2026-08-15T10:00:00Z",
  "ends_at": "2026-08-15T12:00:00Z",
  "comment": "Lunch",
  "class": "blue"
}

Path Parameters​

  • staffer_uuid (string, required): The UUID of the staff member whose calendar is blocked.

Body Parameters​

  • location_uuid (string, required): The location the block applies to. The staffer must be attached to this location.
  • starts_at (string, required): The start of the blocked range, UTC in ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).
  • ends_at (string, required): The end of the blocked range, UTC in ISO 8601. Must be after starts_at.
  • comment (string, optional): A note for the block.
  • class (string, optional): A configured color key.

Example Response​

{
  "staffer_uuid": "eac5a506-69c0-40c4-8758-85c501d26bcb",
  "location_uuid": "123b2980-3506-4f8c-abce-97e1ab653406",
  "starts_at": "2026-08-15T10:00:00Z",
  "ends_at": "2026-08-15T12:00:00Z",
  "comment": "Lunch",
  "class": "blue"
}