Calendar & Scheduling

Blocked Times

A BlockedTime carves a window out of a practitioner's, room's, or bookable area's calendar so it cannot be booked. Use blocked times for breaks, cleaning slots, internal meetings, or any other reason an otherwise-available resource should be hidden from the booking flow. Blocked times can recur on chosen weekdays via the recurrence payload.

get/shop/blocked-times

List blocked times

listBlockedTimes

Returns every BlockedTime at the given site whose window intersects the date_from..date_to range. Use this to render the operator calendar's "blocked" overlays alongside bookings and appointments.

Both date_from and date_to are required and inclusive.

Requires the RESERVATIONS_VIEW permission on the site.

Query parameters

site_idstringrequired
Filter results by the site they belong to
date_fromdaterequired
First date to include in the listing, inclusive. ISO-8601 YYYY-MM-DD in the site's timezone.
date_todaterequired
Last date to include in the listing, inclusive. ISO-8601 YYYY-MM-DD in the site's timezone.

Responses

200
A list of BlockedTimes falling within the requested date range.
401
The user is unauthenticated
403
The authenticated user does not have permission.
422
The request didn't pass validation

curl "https://api.playground.try.be/shop/blocked-times?site_id=site_abc123&date_from=2026-01-15&date_to=2026-01-15" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.playground.try.be/shop/blocked-times?site_id=site_abc123&date_from=2026-01-15&date_to=2026-01-15', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
  },
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.get(
    "https://api.playground.try.be/shop/blocked-times?site_id=site_abc123&date_from=2026-01-15&date_to=2026-01-15",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.playground.try.be/shop/blocked-times?site_id=site_abc123&date_from=2026-01-15&date_to=2026-01-15', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.playground.try.be/shop/blocked-times?site_id=site_abc123&date_from=2026-01-15&date_to=2026-01-15", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A list of `BlockedTime`s falling within the requested date range.

{
  "data": [
    {
      "id": "65f1234567890abcdef12345",
      "start_time": "2026-06-01T09:00:00+01:00",
      "end_time": "2026-06-01T09:30:00+01:00",
      "type": "cleaning",
      "label": "Deep clean",
      "notes": "Used the extra steamer",
      "color": "#ff8800",
      "practitioner_ids": [
        "64a9f3b2c3d8e1f4a5b6c7d8"
      ],
      "room_ids": [
        "64a9f3b2c3d8e1f4a5b6c7d8"
      ],
      "area_ids": [
        "64a9f3b2c3d8e1f4a5b6c7d8"
      ],
      "site_id": "00000000-0000-0000-0000-000000000000",
      "organisation_id": "00000000-0000-0000-0000-000000000000"
    }
  ]
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}

post/shop/blocked-times

Create a blocked time

createBlockedTime

Carves a window out of one or more resource calendars (practitioners, rooms, or bookable areas). At least one of practitioner_ids, room_ids, or area_ids must be non-empty.

If recurrence.weekdays is set, the server fans the block out across matching weekdays within recurrence.date_from..recurrence.date_to (max 366 days). The first ~30 occurrences are created synchronously; the remainder are queued via an async job.

Requires the RESERVATIONS_MANAGE permission on the site.

Request body

start_timedate-timerequired
Start of the blocked window. ISO-8601, in the site's timezone.
end_timedate-timerequired
End of the blocked window. Must be strictly after start_time.
typestringrequired
The kind of block. Drives the calendar icon.
Possible values:cleaningbreakmeetingother
labelstringoptionalnullable
Optional short label shown on the calendar tile.
notesstringoptionalnullable
Optional longer note (plain text).
colorstringoptionalnullable
Optional hex colour override. Format #rrggbb (lower-case).
practitioner_idsstring[]optional
Practitioners whose calendars should be blocked. Required unless room_ids or area_ids is provided.
room_idsstring[]optional
Rooms to block. Required unless practitioner_ids or area_ids is provided.
area_idsstring[]optional
Bookable areas to block. Required unless practitioner_ids or room_ids is provided.
recurrenceobjectoptional
Optional recurrence configuration sent with a BlockedTime create request. When weekdays is non-empty, the server fans out copies of the blocked time across the matching weekdays in date_from..date_to.

The configured range cannot exceed 366 days.
site_iduuidoptional
ID of the site to create the blocked time at. The caller must have the RESERVATIONS_MANAGE permission on it. Defaults to the caller's default site when omitted.

Responses

201
A single BlockedTime.
400
The request failed.
401
The user is unauthenticated
403
The authenticated user does not have permission.
422
The request didn't pass validation

curl -X POST "https://api.playground.try.be/shop/blocked-times" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "start_time": "2026-06-01T09:00:00+01:00",
  "end_time": "2026-06-01T09:30:00+01:00",
  "type": "cleaning",
  "label": "Lunch",
  "notes": "Cover the front desk with reception.",
  "color": "#ff8800",
  "practitioner_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "room_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "area_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "recurrence": {
    "weekdays": [
      "monday"
    ],
    "date_from": "2026-01-15",
    "date_to": "2026-01-15"
  },
  "site_id": "00000000-0000-0000-0000-000000000000"
}'

const response = await fetch('https://api.playground.try.be/shop/blocked-times', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    "start_time": "2026-06-01T09:00:00+01:00",
    "end_time": "2026-06-01T09:30:00+01:00",
    "type": "cleaning",
    "label": "Lunch",
    "notes": "Cover the front desk with reception.",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "recurrence": {
      "weekdays": [
        "monday"
      ],
      "date_from": "2026-01-15",
      "date_to": "2026-01-15"
    },
    "site_id": "00000000-0000-0000-0000-000000000000"
  }),
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.post(
    "https://api.playground.try.be/shop/blocked-times",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "start_time": "2026-06-01T09:00:00+01:00",
        "end_time": "2026-06-01T09:30:00+01:00",
        "type": "cleaning",
        "label": "Lunch",
        "notes": "Cover the front desk with reception.",
        "color": "#ff8800",
        "practitioner_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "room_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "area_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "recurrence": {
            "weekdays": [
                "monday"
            ],
            "date_from": "2026-01-15",
            "date_to": "2026-01-15"
        },
        "site_id": "00000000-0000-0000-0000-000000000000"
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.playground.try.be/shop/blocked-times', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
            'start_time' => '2026-06-01T09:00:00+01:00',
            'end_time' => '2026-06-01T09:30:00+01:00',
            'type' => 'cleaning',
            'label' => 'Lunch',
            'notes' => 'Cover the front desk with reception.',
            'color' => '#ff8800',
            'practitioner_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'room_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'area_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'recurrence' => [
                'weekdays' => [
                    'monday'
                ],
                'date_from' => '2026-01-15',
                'date_to' => '2026-01-15'
            ],
            'site_id' => '00000000-0000-0000-0000-000000000000'
        ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]interface{}{
		"start_time": "2026-06-01T09:00:00+01:00",
		"end_time": "2026-06-01T09:30:00+01:00",
		"type": "cleaning",
		"label": "Lunch",
		"notes": "Cover the front desk with reception.",
		"color": "#ff8800",
		"practitioner_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"room_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"area_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"recurrence": map[string]interface{}{
			"weekdays": []interface{}{
				"monday",
			},
			"date_from": "2026-01-15",
			"date_to": "2026-01-15",
		},
		"site_id": "00000000-0000-0000-0000-000000000000",
	})
	req, _ := http.NewRequest("POST", "https://api.playground.try.be/shop/blocked-times", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `BlockedTime`.

{
  "data": {
    "id": "65f1234567890abcdef12345",
    "start_time": "2026-06-01T09:00:00+01:00",
    "end_time": "2026-06-01T09:30:00+01:00",
    "type": "cleaning",
    "label": "Deep clean",
    "notes": "Used the extra steamer",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "site_id": "00000000-0000-0000-0000-000000000000",
    "organisation_id": "00000000-0000-0000-0000-000000000000"
  }
}

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}

get/shop/blocked-times/{blockedTimeId}

Get a blocked time

getBlockedTime

Returns a single BlockedTime by ID. Useful when reopening the calendar tile to edit it, or to verify a record was created with the expected resource targets.

Requires the RESERVATIONS_VIEW permission on the blocked time's site.

Path parameters

blockedTimeIdobject-idrequired
The ID of the blocked time.

Responses

200
A single BlockedTime.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found

curl "https://api.playground.try.be/shop/blocked-times/abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.playground.try.be/shop/blocked-times/abc123', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
  },
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.get(
    "https://api.playground.try.be/shop/blocked-times/abc123",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.playground.try.be/shop/blocked-times/abc123', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.playground.try.be/shop/blocked-times/abc123", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `BlockedTime`.

{
  "data": {
    "id": "65f1234567890abcdef12345",
    "start_time": "2026-06-01T09:00:00+01:00",
    "end_time": "2026-06-01T09:30:00+01:00",
    "type": "cleaning",
    "label": "Deep clean",
    "notes": "Used the extra steamer",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "site_id": "00000000-0000-0000-0000-000000000000",
    "organisation_id": "00000000-0000-0000-0000-000000000000"
  }
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}

put/shop/blocked-times/{blockedTimeId}

Update a blocked time

updateBlockedTime

Updates an existing BlockedTime. Fields are individually optional. Use the old_* / new_* pairs to swap a single resource (practitioner, room, or area) without resubmitting the full ID list.

The response is 201 Created when the update split a recurring blocked time into a new instance (so a new ID is returned) and 200 OK otherwise.

Requires the RESERVATIONS_MANAGE permission on the blocked time's site.

Path parameters

blockedTimeIdobject-idrequired
The ID of the blocked time.

Request body

start_timedate-timeoptional
New start of the blocked window. ISO-8601, in the site's timezone.
end_timedate-timeoptional
New end time. Must be strictly after start_time.
typestringoptional
New block type. Drives the calendar icon and the reporting category.
Possible values:cleaningbreakmeetingother
labelstringoptionalnullable
Replacement short label shown on the calendar tile. Pass null to clear.
notesstringoptionalnullable
Replacement free-form note (plain text). Pass null to clear.
colorstringoptionalnullable
Updated hex colour (#rrggbb).
practitioner_idsstring[]optional
Replaces the practitioner targets. Practitioners absent from the list are no longer blocked.
room_idsstring[]optional
Replaces the room targets. Rooms absent from the list are no longer blocked.
area_idsstring[]optional
Replaces the bookable-area targets. Areas absent from the list are no longer blocked.
old_practitioner_idobject-idoptional
Existing practitioner ID to swap. Used with new_practitioner_id to update a single calendar without rebuilding the list.
new_practitioner_idobject-idoptional
Replacement practitioner ID for the swap.
old_room_idobject-idoptional
Existing room ID to swap.
new_room_idobject-idoptional
Replacement room ID for the swap.
old_area_idobject-idoptional
Existing bookable-area ID to swap.
new_area_idobject-idoptional
Replacement bookable-area ID for the swap.

Responses

200
A single BlockedTime.
201
A single BlockedTime.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found
422
The request didn't pass validation

curl -X PUT "https://api.playground.try.be/shop/blocked-times/abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "start_time": "2026-01-15T09:30:00+00:00",
  "end_time": "2026-01-15T09:30:00+00:00",
  "type": "cleaning",
  "label": "Lunch",
  "notes": "Cover the front desk with reception.",
  "color": "#ff8800",
  "practitioner_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "room_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "area_ids": [
    "64a9f3b2c3d8e1f4a5b6c7d8"
  ],
  "old_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
  "new_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
  "old_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
  "new_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
  "old_area_id": "64a9f3b2c3d8e1f4a5b6c7d8",
  "new_area_id": "64a9f3b2c3d8e1f4a5b6c7d8"
}'

const response = await fetch('https://api.playground.try.be/shop/blocked-times/abc123', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    "start_time": "2026-01-15T09:30:00+00:00",
    "end_time": "2026-01-15T09:30:00+00:00",
    "type": "cleaning",
    "label": "Lunch",
    "notes": "Cover the front desk with reception.",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "old_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
    "new_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
    "old_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
    "new_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
    "old_area_id": "64a9f3b2c3d8e1f4a5b6c7d8",
    "new_area_id": "64a9f3b2c3d8e1f4a5b6c7d8"
  }),
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.put(
    "https://api.playground.try.be/shop/blocked-times/abc123",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "start_time": "2026-01-15T09:30:00+00:00",
        "end_time": "2026-01-15T09:30:00+00:00",
        "type": "cleaning",
        "label": "Lunch",
        "notes": "Cover the front desk with reception.",
        "color": "#ff8800",
        "practitioner_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "room_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "area_ids": [
            "64a9f3b2c3d8e1f4a5b6c7d8"
        ],
        "old_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
        "new_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
        "old_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
        "new_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
        "old_area_id": "64a9f3b2c3d8e1f4a5b6c7d8",
        "new_area_id": "64a9f3b2c3d8e1f4a5b6c7d8"
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://api.playground.try.be/shop/blocked-times/abc123', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
            'start_time' => '2026-01-15T09:30:00+00:00',
            'end_time' => '2026-01-15T09:30:00+00:00',
            'type' => 'cleaning',
            'label' => 'Lunch',
            'notes' => 'Cover the front desk with reception.',
            'color' => '#ff8800',
            'practitioner_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'room_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'area_ids' => [
                '64a9f3b2c3d8e1f4a5b6c7d8'
            ],
            'old_practitioner_id' => '64a9f3b2c3d8e1f4a5b6c7d8',
            'new_practitioner_id' => '64a9f3b2c3d8e1f4a5b6c7d8',
            'old_room_id' => '64a9f3b2c3d8e1f4a5b6c7d8',
            'new_room_id' => '64a9f3b2c3d8e1f4a5b6c7d8',
            'old_area_id' => '64a9f3b2c3d8e1f4a5b6c7d8',
            'new_area_id' => '64a9f3b2c3d8e1f4a5b6c7d8'
        ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]interface{}{
		"start_time": "2026-01-15T09:30:00+00:00",
		"end_time": "2026-01-15T09:30:00+00:00",
		"type": "cleaning",
		"label": "Lunch",
		"notes": "Cover the front desk with reception.",
		"color": "#ff8800",
		"practitioner_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"room_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"area_ids": []interface{}{
			"64a9f3b2c3d8e1f4a5b6c7d8",
		},
		"old_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
		"new_practitioner_id": "64a9f3b2c3d8e1f4a5b6c7d8",
		"old_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
		"new_room_id": "64a9f3b2c3d8e1f4a5b6c7d8",
		"old_area_id": "64a9f3b2c3d8e1f4a5b6c7d8",
		"new_area_id": "64a9f3b2c3d8e1f4a5b6c7d8",
	})
	req, _ := http.NewRequest("PUT", "https://api.playground.try.be/shop/blocked-times/abc123", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `BlockedTime`.

{
  "data": {
    "id": "65f1234567890abcdef12345",
    "start_time": "2026-06-01T09:00:00+01:00",
    "end_time": "2026-06-01T09:30:00+01:00",
    "type": "cleaning",
    "label": "Deep clean",
    "notes": "Used the extra steamer",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "site_id": "00000000-0000-0000-0000-000000000000",
    "organisation_id": "00000000-0000-0000-0000-000000000000"
  }
}

{
  "data": {
    "id": "65f1234567890abcdef12345",
    "start_time": "2026-06-01T09:00:00+01:00",
    "end_time": "2026-06-01T09:30:00+01:00",
    "type": "cleaning",
    "label": "Deep clean",
    "notes": "Used the extra steamer",
    "color": "#ff8800",
    "practitioner_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "room_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "area_ids": [
      "64a9f3b2c3d8e1f4a5b6c7d8"
    ],
    "site_id": "00000000-0000-0000-0000-000000000000",
    "organisation_id": "00000000-0000-0000-0000-000000000000"
  }
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}

delete/shop/blocked-times/{blockedTimeId}

Delete a blocked time

deleteBlockedTime

Removes a single BlockedTime. Recurring instances must be deleted individually — there is no bulk-delete-the-series operation.

Requires the RESERVATIONS_MANAGE permission on the blocked time's site.

Path parameters

blockedTimeIdobject-idrequired
The ID of the blocked time.

Responses

204
The blocked time was deleted successfully.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found

curl -X DELETE "https://api.playground.try.be/shop/blocked-times/abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.playground.try.be/shop/blocked-times/abc123', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
  },
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.delete(
    "https://api.playground.try.be/shop/blocked-times/abc123",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.playground.try.be/shop/blocked-times/abc123', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("DELETE", "https://api.playground.try.be/shop/blocked-times/abc123", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

The blocked time was deleted successfully.

// empty response

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}