Skip to main content
POST
/
v1
/
spaces
Error
A valid request URL is required to generate request examples
{
  "name": "Meeting Room - 4 people",
  "label": "meeting-room-4-people",
  "description": "Modern meeting room equipped with a whiteboard, video conferencing capabilities, and Google Cast for presentations. Perfect for small team meetings.",
  "capacity": 4,
  "type": "meeting_room",
  "venue": {
    "name": "Downtown Event Center",
    "address": {},
    "label": "downtown-event-center",
    "type": "coworking",
    "spaces": [
      "<array>"
    ],
    "openingHours": [
      {
        "day": "monday",
        "open": "09:00",
        "close": "18:00"
      },
      {
        "day": "tuesday",
        "open": "09:00",
        "close": "18:00"
      }
    ],
    "metadata": {
      "import": "calendarId",
      "googleCalendarId": "primary"
    },
    "medias": [
      "<array>"
    ]
  },
  "products": [
    {
      "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
      "reference": "one-day-pass",
      "name": "One Day Pass",
      "description": "Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM.",
      "price": 2500,
      "type": "one_time",
      "category": "booking",
      "metadata": {
        "durationType": "daily",
        "durationValue": 1
      },
      "currency": "EUR",
      "spaces": [
        "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
        "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
      ]
    }
  ],
  "metadata": {
    "color": "#FF0000",
    "amenities": [
      "whiteboard",
      "projector",
      "wifi"
    ],
    "equipment": [
      "laptop",
      "monitor"
    ]
  },
  "totalBookings": 0
}

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Body

application/json
​
name
string
required

Display name of the space. Shown to users in booking interfaces.

Example:

"Meeting Room - 4 people"

​
description
string
required

Detailed description of the space for end-users. Should highlight features, amenities, and any special characteristics.

Example:

"Modern meeting room equipped with a whiteboard, video conferencing capabilities, and Google Cast for presentations. Perfect for small team meetings."

​
capacity
number
required

Maximum number of people the space can accommodate. Used for capacity filtering and booking validation.

Required range: x >= 1
Example:

4

​
type
enum<string>
required

Type of space, which determines available features, booking rules, and product compatibility.

Available options:
meeting_room,
desk,
bedroom,
court,
studio,
conference_room,
event_hall,
gym_area,
podcast_booth,
restaurant_table,
retail_counter,
parking_spot,
generic
Example:

"meeting_room"

​
metadata
object
required

Additional metadata for the space. Can include custom properties like color coding, amenities, equipment, or integration-specific data.

Example:
{
  "color": "#FF0000",
  "amenities": ["whiteboard", "projector", "wifi"],
  "equipment": ["laptop", "monitor"]
}
​
totalBookings
number
required

Total number of bookings (past and future) associated with this space. Useful for analytics and space utilization metrics.

Required range: x >= 0
Example:

0

​
venue
string<uuid>
required

Unique identifier of the venue where this space is located. The space will be associated with this venue.

Example:

"a5d2c2c6-5d5c-4b6b-8c4d-0f7c5d6e5b4d"

​
products
string[]

Array of product IDs to associate with this space. These products will be available for booking in this space. Can be empty if products will be added later.

Example:
["prod_123", "prod_456"]

Response

Space created successfully with all details including capacity, type, and associated products

​
name
string
required

Display name of the space. Shown to users in booking interfaces.

Example:

"Meeting Room - 4 people"

​
label
string
required

URL-friendly public identifier (slug) for the space. Used in URLs and API calls. Must be unique within the venue.

Example:

"meeting-room-4-people"

​
description
string
required

Detailed description of the space for end-users. Should highlight features, amenities, and any special characteristics.

Example:

"Modern meeting room equipped with a whiteboard, video conferencing capabilities, and Google Cast for presentations. Perfect for small team meetings."

​
capacity
number
required

Maximum number of people the space can accommodate. Used for capacity filtering and booking validation.

Required range: x >= 1
Example:

4

​
type
enum<string>
required

Type of space, which determines available features and booking rules. Different space types may have different product options and pricing.

Available options:
meeting_room,
desk,
bedroom,
court,
studio,
conference_room,
event_hall,
gym_area,
podcast_booth,
restaurant_table,
retail_counter,
parking_spot,
generic
Example:

"meeting_room"

​
venue
required

The venue this space belongs to. Can be returned as a full VenueDto object or just the venue ID string.

​
products
object[]
required

List of products available for booking in this space. Each product defines pricing, duration, and booking conditions specific to this space.

​
metadata
object
required

Additional metadata for the space. Can include custom properties like color coding, amenities, equipment, or integration-specific data.

Example:
{
  "color": "#FF0000",
  "amenities": ["whiteboard", "projector", "wifi"],
  "equipment": ["laptop", "monitor"]
}
​
totalBookings
number
required

Total number of bookings (past and future) associated with this space. Useful for analytics and space utilization metrics.

Required range: x >= 0
Example:

0