Block staff time
Blocks a staff member's agenda for a period, once or repeating, so no client can book online in it.
POST https://cotlet.dev/api/v1/planity/staffs/{staff_id}/time/block
write
Returns the block with an id. Planity says no client can book online in the blocked time. It does not move or delete appointments already in the period: list_appointments shows them. A block reaches no one and is undone with remove_block, so it does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| staff_id string required | string | Id from list_staff. |
| start string required | string | Start of the block, ISO 8601, in the salon's local time. |
| end string required | string | End of the block, same day as start. |
| repeat string | string | How the block repeats: none (default), daily or weekly. |
Request
curl -X POST https://cotlet.dev/api/v1/planity/staffs/st_01/time/block \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"start":"2026-10-26T09:00:00","end":"2026-10-26T13:00:00","repeat":"weekly"}'result = client.call("planity", "block_time", {"staff_id":"st_01","start":"2026-10-26T09:00:00","end":"2026-10-26T13:00:00","repeat":"weekly"})const result = await cotlet.call('planity', 'block_time', {"staff_id":"st_01","start":"2026-10-26T09:00:00","end":"2026-10-26T13:00:00","repeat":"weekly"});cotlet call planity block_time --data '{"staff_id":"st_01","start":"2026-10-26T09:00:00","end":"2026-10-26T13:00:00","repeat":"weekly"}'Example response
{
"block_id": "b_330",
"staff": {
"staff_id": "st_01",
"name": "Amélie"
},
"start": "2026-10-26T09:00:00",
"end": "2026-10-26T13:00:00",
"repeat": "weekly",
"online_booking_blocked": true
}