Skip to main content
POST
/
api
/
v1
/
rooms
Create Room
curl --request POST \
  --url https://api.example.com/api/v1/rooms \
  --header 'Content-Type: application/json' \
  --data '
{
  "room_number": "<string>",
  "block_id": "<string>",
  "instance_id": "<string>",
  "name": "<string>",
  "capacity": 123
}
'

​
Create Room

Create a new room within a block. Room numbers must be unique within the same block.
​
room_number
string
required
Room number
​
block_id
string
required
Block ID the room belongs to
​
instance_id
string
required
Instance ID
​
name
string
Room name
​
capacity
number
Room capacity
  • Room numbers must be unique within the same block
  • Block must exist and belong to the same instance

​
Example Request

curl -X POST https://api.checkpoint.b-digital.uk/api/v1/rooms \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "room_number": "101",
    "block_id": "block123",
    "instance_id": "se8SajpJDWUwrEmhElLF",
    "name": "Room 101",
    "capacity": 4
  }'