resources
## OpenAPI
````yaml /assets/openapi.json post /resources/v1
openapi: 3.0.2
info:
title: Spacebring
version: 1.0.0
termsOfService: https://www.spacebring.com/terms
servers:
- url: https://api.spacebring.com
security: []
paths:
/resources/v1:
post:
tags:
- Resources
summary: Create a resource
description: >-
Create a new resource in a location. The request body must match the
schema exactly—unknown properties are rejected. resources
operationId: createResource
parameters:
- in: header
name: spacebring-network-id
schema:
type: string
format: uuid
required: false
description: >-
The id of the network. Required when using bearer token
authentication
requestBody:
$ref: '#/components/requestBodies/createResource'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/getResource'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/responseError'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/responseError'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/responseError'
'409':
description: Conflict
content:
application/json:
schema:
$ref: '#/components/schemas/responseError'
security:
- BasicAuth: []
- OAuth2:
- resources
components:
requestBodies:
createResource:
content:
application/json:
schema:
type: object
properties:
resource:
type: object
description: Resource fields to create.
properties:
autoRelease:
description: Auto-release settings for no-show bookings.
type: object
properties:
enabled:
type: boolean
description: Whether auto-release is enabled.
interval:
type: string
enum:
- fiveMinutes
- tenMinutes
- fifteenMinutes
description: >-
Minutes after start or creation before the slot is
released.
required:
- enabled
- interval
avigilonAltaGroupRef:
description: Avigilon Alta access group reference.
nullable: true
type: number
bookingPermission:
type: string
enum:
- admins
- exclusiveMembers
- members
- networkMembers
- public
description: Who can create bookings on this resource.
bookingStepMinutes:
description: Booking step size in minutes.
type: number
bookingUnit:
description: >-
Whether bookings are measured in hours or in whole days.
With day, bookings always cover the whole schedule of the
day and the duration bounds are set to 24 hours. Defaults
to hour.
type: string
enum:
- hour
- day
brivoGroupRef:
description: Brivo access group reference.
nullable: true
type: number
bufferTime:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
- thirtyMinutes
- sixtyMinutes
description: Buffer time blocked before each booking.
capacity:
description: Maximum capacity per booking.
nullable: true
type: number
checkIn:
description: Check-in settings.
type: object
properties:
interval:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
description: How early before start the guest must check in.
required:
- interval
confirmationEmail:
description: Confirmation email settings.
type: object
properties:
bookingCreatedByAdmin:
type: boolean
description: Send confirmation when an admin creates a booking.
bookingCreatedByMember:
type: boolean
description: Send confirmation when a member creates a booking.
bookingCreatedByNetworkMember:
type: boolean
description: >-
Send confirmation when a network member creates a
booking.
bookingCreatedByPublic:
type: boolean
description: >-
Send confirmation when a public user creates a
booking.
template:
type: string
description: Email template id for confirmation emails.
required:
- bookingCreatedByAdmin
- bookingCreatedByMember
- bookingCreatedByNetworkMember
- bookingCreatedByPublic
- template
credits:
description: Credit pricing settings.
type: object
properties:
enabled:
type: boolean
description: Whether customers can pay with location credits.
price:
description: Optional display price; tier data is authoritative.
type: number
tiers:
type: array
items:
type: object
properties:
flatAmount:
type: number
description: Fixed fee added once to bookings in this tier.
from:
type: number
description: >-
Booking length in minutes at which this tier
starts, for example 480 for 8 hours.
unitAmount:
type: number
description: >-
Price per hour of booking within this tier, not
per minute, for example 40 for 40 per hour.
required:
- flatAmount
- from
- unitAmount
description: Stepped credit pricing tiers.
required:
- enabled
- tiers
dayPassesEnabled:
description: >-
Whether members can book this resource with day passes.
Only hotDesk resources support day passes; enabling it for
any other type is rejected.
type: boolean
description:
type: string
description: Description of the resource.
duration:
description: Booking duration bounds.
type: object
properties:
max:
type: number
description: Maximum booking duration in minutes.
min:
type: number
description: Minimum booking duration in minutes.
public:
type: object
properties:
enabled:
type: boolean
description: >-
Whether public bookers have separate duration
limits.
max:
type: number
description: >-
Maximum booking duration in minutes for public
bookers.
min:
type: number
description: >-
Minimum booking duration in minutes for public
bookers.
required:
- enabled
- max
- min
description: Duration limits for public bookers.
required:
- max
- min
- public
dynamicPricing:
description: Dynamic pricing settings.
type: object
properties:
deltaAbove:
type: number
description: Maximum price increase percentage when demand is high.
deltaBelow:
type: number
description: Maximum price decrease percentage when demand is low.
enabled:
type: boolean
description: Whether dynamic pricing is enabled.
required:
- deltaAbove
- deltaBelow
- enabled
googleCalendar:
description: >-
Google Calendar integration settings. Pass null to
disconnect the calendar from the resource.
nullable: true
type: object
properties:
id:
type: string
description: Google Calendar id.
twoWaySyncEnabled:
type: boolean
description: Whether two-way sync is enabled.
required:
- id
- twoWaySyncEnabled
id:
description: Optional client-provided resource id.
type: string
format: uuid
kisiGroupRef:
description: Kisi access group reference.
nullable: true
type: number
locationRef:
type: string
format: uuid
description: ID of the location.
media:
description: >-
Images of the resource in display order, the first one
being its cover. On update the list replaces the current
images, and an empty list removes them all.
maxItems: 10
type: array
items:
type: object
properties:
key:
type: string
description: >-
Storage key of the uploaded image, as returned by
the media upload endpoint.
required:
- key
money:
description: Money pricing settings.
type: object
properties:
enabled:
type: boolean
description: Whether customers can pay with money.
price:
description: Optional display price; tier data is authoritative.
type: number
tiers:
type: array
items:
type: object
properties:
flatAmount:
type: number
description: Fixed fee added once to bookings in this tier.
from:
type: number
description: >-
Booking length in minutes at which this tier
starts, for example 480 for 8 hours.
unitAmount:
type: number
description: >-
Price per hour of booking within this tier, not
per minute, for example 40 for 40 per hour.
required:
- flatAmount
- from
- unitAmount
description: Stepped money pricing tiers.
required:
- enabled
- tiers
outlookCalendar:
description: >-
Outlook Calendar integration settings. Pass null to
disconnect the calendar from the resource.
nullable: true
type: object
properties:
id:
type: string
description: Outlook calendar id.
twoWaySyncEnabled:
type: boolean
description: Whether two-way sync is enabled.
required:
- id
- twoWaySyncEnabled
parentRef:
description: Parent resource id when creating a child resource.
nullable: true
type: string
format: uuid
plans:
description: Membership plan tiers sold for this resource.
type: object
properties:
enabled:
type: boolean
description: >-
Whether membership plans can be sold for this
resource.
tiers:
type: array
items:
type: object
properties:
addons:
default: []
description: Addons included in the tier.
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Addon id.
required:
- id
commitmentCycles:
type: number
description: >-
Number of billing cycles the member commits to
for this tier.
credits:
type: number
description: >-
Credits included per period in this membership
tier.
dayPasses:
description: >-
Optional number of day passes bundled with the
tier.
type: number
description:
description: Marketing or internal description of the tier.
type: string
discounts:
deprecated: true
description: Synthetic discount percentages by product type.
type: object
properties:
creditPackages:
type: number
description: Discount percentage for credit packages.
desks:
type: number
description: Discount percentage for desk bookings.
equipment:
type: number
description: Discount percentage for equipment bookings.
events:
type: number
description: Discount percentage for events.
rooms:
type: number
description: Discount percentage for room bookings.
shop:
type: number
description: Discount percentage for shop products.
entire:
type: boolean
description: >-
If true, tier grants access to the whole
resource.
ezeepBlueGroupRef:
description: Ezeep Blue printing group reference.
type: string
grantedDiscounts:
description: Coupons to grant to members on this tier.
type: array
items:
type: object
properties:
coupon:
type: object
properties:
amountOff:
description: Fixed discount amount.
type: number
currencyCode:
description: Currency code for amountOff.
type: string
id:
type: string
format: uuid
description: Unique identifier of the coupon.
percentOff:
description: Percentage discount.
type: number
productTypes:
type: array
items:
type: string
enum:
- roomBookings
- eventSpaceBookings
- conferenceRoomBookings
- meetingRoomBookings
- phoneBoothBookings
- stationBookings
- studioBookings
- hotDeskBookings
- dedicatedDeskBookings
- officeBookings
- parkingBookings
- equipmentBookings
- eventTickets
- shopProducts
- packages
- subscriptionItems
description: Product types the coupon applies to.
required:
- id
description: Coupon to grant.
required:
- coupon
id:
type: string
format: uuid
description: Unique identifier of the tier.
period:
type: string
enum:
- day
- week
- month
- threeMonths
- sixMonths
- year
description: Billing period label for the tier.
price:
type: number
description: >-
Recurring price for this tier in the location
currency.
selfSignup:
description: Self sign-up settings of the tier.
type: object
properties:
enabled:
type: boolean
description: >-
Whether members may self-enroll into the
tier.
type:
type: string
description: Self sign-up flow type.
required:
- enabled
- type
selfSignupType:
deprecated: true
description: >-
Deprecated. Use selfSignup.type instead. How
members may self-enroll, if applicable.
type: string
setupFee:
description: >-
One-time fee charged when subscribing to this
tier.
type: number
title:
type: string
description: Display name of the plan tier.
required:
- commitmentCycles
- credits
- entire
- id
- period
- price
- title
description: Sellable membership options for this resource.
required:
- enabled
- tiers
preparationMinutes:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
- thirtyMinutes
- sixtyMinutes
description: Deprecated. Use bufferTime instead.
deprecated: true
refundThreshold:
type: string
enum:
- noRefund
- zeroMinutes
- fifteenMinutes
- thirtyMinutes
- oneHour
- twoHours
- fourHours
- sixHours
- twelveHours
- oneDay
- twoDays
- oneWeek
- twoWeeks
- fourWeeks
description: How long before start a booking remains refundable.
saltoksAccessGroupRef:
description: Salto KS access group reference.
nullable: true
type: string
format: uuid
schedule:
description: Availability schedule.
type: object
properties:
default:
type: object
properties:
closedDays:
type: array
items:
type: string
description: Dates in MM-DD format when the resource is closed.
items:
type: array
items:
type: object
properties:
days:
type: object
properties:
friday:
type: boolean
description: >-
Whether Friday is included in this
schedule window.
monday:
type: boolean
description: >-
Whether Monday is included in this
schedule window.
saturday:
type: boolean
description: >-
Whether Saturday is included in this
schedule window.
sunday:
type: boolean
description: >-
Whether Sunday is included in this
schedule window.
thursday:
type: boolean
description: >-
Whether Thursday is included in this
schedule window.
tuesday:
type: boolean
description: >-
Whether Tuesday is included in this
schedule window.
wednesday:
type: boolean
description: >-
Whether Wednesday is included in this
schedule window.
required:
- friday
- monday
- saturday
- sunday
- thursday
- tuesday
- wednesday
description: Weekdays this time window applies to.
hours:
type: object
properties:
from:
type: string
description: Opening time in 24-hour "HH:mm" format.
to:
description: >-
Closing time in 24-hour format, counted
from the start of the weekday. A day
that stays open past midnight closes
after 24:00, for example at 26:00 for
2:00 AM the next day, and at most 24
hours after the opening time.
type: string
required:
- from
- to
description: Open hours for the selected weekdays.
required:
- days
- hours
description: Weekly availability windows for members.
required:
- closedDays
- items
description: Default availability schedule.
enabled:
type: boolean
description: Whether scheduling is enabled.
public:
type: object
properties:
closedDays:
type: array
items:
type: string
description: >-
Dates in MM-DD format when the resource is closed
for public bookers.
enabled:
type: boolean
description: Whether the public schedule is enabled.
items:
type: array
items:
type: object
properties:
days:
type: object
properties:
friday:
type: boolean
description: >-
Whether Friday is included in this
schedule window.
monday:
type: boolean
description: >-
Whether Monday is included in this
schedule window.
saturday:
type: boolean
description: >-
Whether Saturday is included in this
schedule window.
sunday:
type: boolean
description: >-
Whether Sunday is included in this
schedule window.
thursday:
type: boolean
description: >-
Whether Thursday is included in this
schedule window.
tuesday:
type: boolean
description: >-
Whether Tuesday is included in this
schedule window.
wednesday:
type: boolean
description: >-
Whether Wednesday is included in this
schedule window.
required:
- friday
- monday
- saturday
- sunday
- thursday
- tuesday
- wednesday
description: Weekdays this time window applies to.
hours:
type: object
properties:
from:
type: string
description: Opening time in 24-hour "HH:mm" format.
to:
description: >-
Closing time in 24-hour format, counted
from the start of the weekday. A day
that stays open past midnight closes
after 24:00, for example at 26:00 for
2:00 AM the next day, and at most 24
hours after the opening time.
type: string
required:
- from
- to
description: Open hours for the selected weekdays.
required:
- days
- hours
description: Weekly availability windows for public bookers.
required:
- closedDays
- enabled
- items
description: Public availability schedule.
required:
- default
- enabled
- public
tapkeyGroupRef:
description: Tapkey access group reference.
nullable: true
type: string
format: uuid
unifiAccessGroupRef:
description: UniFi Access policy reference.
nullable: true
type: string
title:
type: string
minLength: 1
description: Display name of the resource.
type:
type: string
enum:
- dedicatedDesk
- equipment
- hotDesk
- office
- parkingLot
- room
- station
- conferenceRoom
- eventSpace
- meetingRoom
- phoneBooth
- studio
description: Type of the resource.
visibility:
type: string
enum:
- admins
- exclusiveMembers
- members
- networkMembers
- public
description: Who can see this resource in listings.
required:
- locationRef
- title
- type
required:
- resource
required: true
schemas:
getResource:
type: object
properties:
resource:
type: object
additionalProperties: false
description: The resource.
properties:
assignments:
type: array
items:
type: object
properties:
company:
deprecated: true
description: >-
Deprecated. Use customer instead. Company assigned to the
resource.
type: object
properties:
id:
type: string
format: uuid
description: Company id.
title:
description: >-
Company name. Present only for admin callers and the
customer's own assignments.
type: string
required:
- id
additionalProperties: false
customer:
description: Customer the resource is assigned to.
type: object
properties:
id:
type: string
format: uuid
description: Customer id.
title:
description: Company name when the customer is a company.
type: string
type:
type: string
enum:
- user
- company
description: Whether the customer is a user or company.
user:
description: User details when the customer is a user.
type: object
properties:
email:
description: User email.
nullable: true
type: string
id:
type: string
format: uuid
description: User id.
name:
description: User first name.
nullable: true
type: string
surname:
description: User last name.
nullable: true
type: string
required:
- id
additionalProperties: false
required:
- id
- type
additionalProperties: false
endDate:
description: ISO timestamp when the assignment ends.
type: string
entire:
type: boolean
description: >-
Whether the assignment grants access to the entire
resource.
id:
description: Assignment id.
type: string
format: uuid
membership:
deprecated: true
description: >-
Deprecated. Use customer instead. Membership linked to the
assignment.
type: object
properties:
id:
type: string
format: uuid
description: Membership id.
required:
- id
additionalProperties: false
quantity:
description: Assigned quantity when the resource is partially assigned.
type: number
resource:
description: >-
Resource the assignment belongs to. Present when
assignments are listed on their own.
type: object
properties:
id:
type: string
format: uuid
description: Resource id.
imageUrl:
description: Resource image URL.
type: string
locationRef:
type: string
format: uuid
description: UUID of the location the resource belongs to.
title:
type: string
description: Resource title.
type:
type: string
description: Resource type.
required:
- id
- locationRef
- title
- type
additionalProperties: false
resourceRef:
type: string
format: uuid
description: UUID of the resource the assignment belongs to.
startDate:
type: string
description: ISO timestamp when the assignment starts.
subscription:
type: object
properties:
endDate:
description: ISO timestamp when the assignment ends.
type: string
id:
description: >-
Subscription id. Absent for assignments created
directly by an admin.
type: string
format: uuid
startDate:
type: string
description: ISO timestamp when the assignment starts.
required:
- startDate
additionalProperties: false
description: >-
Deprecated. Use startDate and endDate instead.
Subscription backing this assignment.
user:
deprecated: true
description: >-
Deprecated. Use customer instead. User assigned to the
resource.
type: object
properties:
email:
description: User email.
nullable: true
type: string
id:
type: string
format: uuid
description: User id.
name:
description: User first name.
nullable: true
type: string
surname:
description: User last name.
nullable: true
type: string
required:
- id
additionalProperties: false
required:
- entire
- resourceRef
- startDate
- subscription
additionalProperties: false
description: Active resource assignments.
autoRelease:
description: Auto-release settings for no-show bookings.
type: object
properties:
enabled:
type: boolean
description: Whether auto-release is enabled.
interval:
type: string
enum:
- fiveMinutes
- tenMinutes
- fifteenMinutes
description: Minutes after start or creation before the slot is released.
required:
- enabled
- interval
additionalProperties: false
avigilonAltaGroupRef:
description: Avigilon Alta access group reference.
nullable: true
type: number
bookingPermission:
type: string
enum:
- admins
- exclusiveMembers
- members
- networkMembers
- public
description: Who can create bookings on this resource.
bookingStepMinutes:
description: Booking step size in minutes.
type: number
bookingUnit:
type: string
enum:
- hour
- day
description: Whether bookings are measured in hours or in whole days.
brivoGroupRef:
description: Brivo access group reference.
nullable: true
type: number
bufferTime:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
- thirtyMinutes
- sixtyMinutes
description: Buffer time blocked before each booking.
capacity:
description: Maximum capacity per booking.
nullable: true
type: number
checkIn:
description: Check-in settings.
type: object
properties:
interval:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
description: How early before start the guest must check in.
required:
- interval
additionalProperties: false
children:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Id of the child resource.
title:
type: string
description: Title of the child resource.
required:
- id
- title
additionalProperties: false
description: >-
Child resources when this is a parent resource. Bookings on a
child resource also block the parent.
confirmationEmail:
type: object
properties:
bookingCreatedByAdmin:
type: boolean
description: Send confirmation when an admin creates a booking.
bookingCreatedByMember:
type: boolean
description: Send confirmation when a member creates a booking.
bookingCreatedByNetworkMember:
type: boolean
description: Send confirmation when a network member creates a booking.
bookingCreatedByPublic:
type: boolean
description: Send confirmation when a public user creates a booking.
template:
type: string
description: Email template id for confirmation emails.
required:
- bookingCreatedByAdmin
- bookingCreatedByMember
- bookingCreatedByNetworkMember
- bookingCreatedByPublic
- template
additionalProperties: false
description: Confirmation email settings.
createDate:
type: string
format: date-time
description: ISO timestamp of when the resource was created.
credits:
type: object
properties:
enabled:
type: boolean
description: Whether customers can pay with location credits.
tiers:
type: array
items:
type: object
properties:
flatAmount:
type: number
description: Fixed fee added once to bookings in this tier.
from:
type: number
description: >-
Booking length in minutes at which this tier starts,
for example 480 for 8 hours.
unit:
type: string
enum:
- hour
- day
description: Whether the tier is priced per hour or per day.
unitAmount:
type: number
description: >-
Price per unit of booking time within this tier, never
per minute.
required:
- flatAmount
- from
- unit
- unitAmount
additionalProperties: false
description: Stepped credit pricing tiers.
required:
- enabled
- tiers
additionalProperties: false
description: Credit pricing settings.
dayPassesEnabled:
description: >-
Whether members can book this resource with day passes. Only
hotDesk resources support day passes.
type: boolean
description:
type: string
description: Description of the resource.
duration:
type: object
properties:
max:
type: number
description: Maximum booking duration in minutes.
min:
type: number
description: Minimum booking duration in minutes.
public:
type: object
properties:
enabled:
type: boolean
description: Whether public bookers have separate duration limits.
max:
type: number
description: Maximum booking duration in minutes for public bookers.
min:
type: number
description: Minimum booking duration in minutes for public bookers.
required:
- enabled
- max
- min
additionalProperties: false
description: Duration limits for public bookers.
required:
- max
- min
- public
additionalProperties: false
description: Booking duration bounds.
dynamicPricing:
type: object
properties:
deltaAbove:
type: number
description: Maximum price increase percentage when demand is high.
deltaBelow:
type: number
description: Maximum price decrease percentage when demand is low.
enabled:
type: boolean
description: Whether dynamic pricing is enabled.
required:
- deltaAbove
- deltaBelow
- enabled
additionalProperties: false
description: Dynamic pricing settings.
googleCalendar:
description: Google Calendar integration settings.
type: object
properties:
id:
type: string
description: Google Calendar id.
twoWaySyncEnabled:
type: boolean
description: Whether two-way sync is enabled.
required:
- id
- twoWaySyncEnabled
additionalProperties: false
id:
type: string
format: uuid
description: Unique identifier of the resource.
imageUrl:
description: Public URL of the resource's cover, the first image in media.
type: string
kisiGroupRef:
description: Kisi access group reference.
nullable: true
type: number
locale:
type: string
description: Auto-detected language of the description.
locationRef:
type: string
format: uuid
description: ID of the location.
media:
type: array
items:
type: object
properties:
key:
description: Storage key of the image.
type: string
url:
description: Public URL of the image.
type: string
required:
- key
additionalProperties: false
description: >-
Images of the resource in display order, the first one being its
cover.
money:
type: object
properties:
enabled:
type: boolean
description: Whether customers can pay with money.
tiers:
type: array
items:
type: object
properties:
flatAmount:
type: number
description: Fixed fee added once to bookings in this tier.
from:
type: number
description: >-
Booking length in minutes at which this tier starts,
for example 480 for 8 hours.
unit:
type: string
enum:
- hour
- day
description: Whether the tier is priced per hour or per day.
unitAmount:
type: number
description: >-
Price per unit of booking time within this tier, never
per minute.
required:
- flatAmount
- from
- unit
- unitAmount
additionalProperties: false
description: Stepped money pricing tiers.
required:
- enabled
- tiers
additionalProperties: false
description: Money pricing settings.
networkRef:
type: string
format: uuid
description: ID of the network.
outlookCalendar:
description: Outlook Calendar integration settings.
type: object
properties:
id:
type: string
description: Outlook calendar id.
twoWaySyncEnabled:
type: boolean
description: Whether two-way sync is enabled.
required:
- id
- twoWaySyncEnabled
additionalProperties: false
parentRef:
description: Parent resource id when this is a child resource.
type: string
format: uuid
plans:
description: Plan tiers configured on the resource.
type: object
properties:
enabled:
type: boolean
description: Whether plan-based access is enabled.
tiers:
type: array
items:
type: object
properties:
addons:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Addon id.
required:
- id
additionalProperties: false
description: Addons included in the tier.
commitmentCycles:
type: number
description: Number of billing cycles in the tier.
credits:
type: number
description: Credits included in the tier.
dayPasses:
description: Day passes included in the tier.
type: number
description:
description: Description of the tier.
type: string
discounts:
deprecated: true
description: Synthetic discount percentages by product type.
type: object
properties:
creditPackages:
type: number
description: Discount percentage for credit packages.
desks:
type: number
description: Discount percentage for desk bookings.
equipment:
type: number
description: Discount percentage for equipment bookings.
events:
type: number
description: Discount percentage for events.
rooms:
type: number
description: Discount percentage for room bookings.
shop:
type: number
description: Discount percentage for shop products.
additionalProperties: false
entire:
type: boolean
description: Whether the tier grants access to the entire resource.
grantedDiscounts:
type: array
items:
type: object
properties:
coupon:
type: object
properties:
amountOff:
description: Fixed discount amount.
type: number
currencyCode:
description: Currency code for amountOff.
type: string
enabledForCredits:
description: >-
Whether the coupon applies to credit
purchases.
type: boolean
id:
type: string
format: uuid
description: Unique identifier of the coupon.
limitedItems:
type: object
properties:
enabled:
type: boolean
description: Whether item-level limits are enabled.
values:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Unique identifier of the limited item.
title:
description: Display name of the limited item.
type: string
type:
type: string
enum:
- roomBookings
- eventSpaceBookings
- conferenceRoomBookings
- meetingRoomBookings
- phoneBoothBookings
- stationBookings
- studioBookings
- hotDeskBookings
- dedicatedDeskBookings
- officeBookings
- parkingBookings
- equipmentBookings
- eventTickets
- shopProducts
- packages
- subscriptionItems
description: Product type of the limited item.
required:
- id
- type
additionalProperties: false
description: >-
Product or package the coupon is limited
to.
description: >-
Items the coupon applies to when limits
are enabled.
required:
- enabled
- values
additionalProperties: false
description: Item-level redemption limits.
limitedRedemption:
type: object
properties:
enabled:
type: boolean
description: Whether redemption limits are enabled.
usage:
type: number
description: Current redemption count.
value:
type: number
description: Maximum redemption count.
required:
- enabled
- usage
- value
additionalProperties: false
description: Redemption limits for the coupon.
percentOff:
description: Percentage discount.
type: number
productTypes:
type: array
items:
type: string
enum:
- roomBookings
- eventSpaceBookings
- conferenceRoomBookings
- meetingRoomBookings
- phoneBoothBookings
- stationBookings
- studioBookings
- hotDeskBookings
- dedicatedDeskBookings
- officeBookings
- parkingBookings
- equipmentBookings
- eventTickets
- shopProducts
- packages
- subscriptionItems
description: Product types the coupon applies to.
required:
- id
additionalProperties: false
description: Granted coupon details.
required:
- coupon
additionalProperties: false
description: Coupons granted to members on this tier.
id:
type: string
format: uuid
description: Unique identifier of the tier.
period:
type: string
enum:
- day
- week
- month
- threeMonths
- sixMonths
- year
description: Billing period of the tier.
plan:
type: object
properties:
commitmentCycles:
type: number
description: Number of billing cycles in the tier.
credits:
type: number
description: Credits included in the tier.
dayPasses:
description: Day passes included in the tier.
type: number
discounts:
deprecated: true
description: Synthetic discount percentages by product type.
type: object
properties:
creditPackages:
type: number
description: Discount percentage for credit packages.
desks:
type: number
description: Discount percentage for desk bookings.
equipment:
type: number
description: Discount percentage for equipment bookings.
events:
type: number
description: Discount percentage for events.
rooms:
type: number
description: Discount percentage for room bookings.
shop:
type: number
description: Discount percentage for shop products.
additionalProperties: false
grantedDiscounts:
type: array
items:
type: object
properties:
coupon:
type: object
properties:
amountOff:
description: Fixed discount amount.
type: number
currencyCode:
description: Currency code for amountOff.
type: string
enabledForCredits:
description: >-
Whether the coupon applies to credit
purchases.
type: boolean
id:
type: string
format: uuid
description: Unique identifier of the coupon.
limitedItems:
type: object
properties:
enabled:
type: boolean
description: Whether item-level limits are enabled.
values:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Unique identifier of the limited item.
title:
description: Display name of the limited item.
type: string
type:
type: string
enum:
- roomBookings
- eventSpaceBookings
- conferenceRoomBookings
- meetingRoomBookings
- phoneBoothBookings
- stationBookings
- studioBookings
- hotDeskBookings
- dedicatedDeskBookings
- officeBookings
- parkingBookings
- equipmentBookings
- eventTickets
- shopProducts
- packages
- subscriptionItems
description: Product type of the limited item.
required:
- id
- type
additionalProperties: false
description: >-
Product or package the coupon is limited
to.
description: >-
Items the coupon applies to when limits
are enabled.
required:
- enabled
- values
additionalProperties: false
description: Item-level redemption limits.
limitedRedemption:
type: object
properties:
enabled:
type: boolean
description: Whether redemption limits are enabled.
usage:
type: number
description: Current redemption count.
value:
type: number
description: Maximum redemption count.
required:
- enabled
- usage
- value
additionalProperties: false
description: Redemption limits for the coupon.
percentOff:
description: Percentage discount.
type: number
productTypes:
type: array
items:
type: string
enum:
- roomBookings
- eventSpaceBookings
- conferenceRoomBookings
- meetingRoomBookings
- phoneBoothBookings
- stationBookings
- studioBookings
- hotDeskBookings
- dedicatedDeskBookings
- officeBookings
- parkingBookings
- equipmentBookings
- eventTickets
- shopProducts
- packages
- subscriptionItems
description: Product types the coupon applies to.
required:
- id
additionalProperties: false
description: Granted coupon details.
required:
- coupon
additionalProperties: false
description: Coupons granted to members on this tier.
id:
type: string
format: uuid
description: Unique identifier of the tier.
period:
type: string
enum:
- day
- week
- month
- threeMonths
- sixMonths
- year
description: Billing period of the tier.
price:
type: number
description: Price of the tier.
title:
type: string
description: Title of the tier.
required:
- commitmentCycles
- credits
- dayPasses
- grantedDiscounts
- id
- period
- price
- title
additionalProperties: false
description: Nested plan details on responses.
price:
type: number
description: Price of the tier.
selfSignup:
type: object
properties:
enabled:
type: boolean
description: Whether members may self-enroll into the tier.
type:
type: string
description: Self sign-up flow type for the tier.
required:
- enabled
- type
additionalProperties: false
description: Self sign-up settings of the tier.
selfSignupType:
deprecated: true
description: >-
Deprecated. Use selfSignup.type instead. Self sign-up
flow type for the tier.
type: string
setupFee:
type: number
description: One-time setup fee for the tier.
title:
type: string
description: Title of the tier.
required:
- addons
- commitmentCycles
- credits
- entire
- grantedDiscounts
- id
- period
- plan
- price
- selfSignup
- setupFee
- title
additionalProperties: false
description: Plan tiers configured on the resource.
required:
- enabled
- tiers
additionalProperties: false
preparationMinutes:
type: string
enum:
- zeroMinutes
- fiveMinutes
- tenMinutes
- fifteenMinutes
- thirtyMinutes
- sixtyMinutes
description: Deprecated. Use bufferTime instead.
deprecated: true
refundThreshold:
type: string
enum:
- noRefund
- zeroMinutes
- fifteenMinutes
- thirtyMinutes
- oneHour
- twoHours
- fourHours
- sixHours
- twelveHours
- oneDay
- twoDays
- oneWeek
- twoWeeks
- fourWeeks
description: Refund threshold for cancellations.
saltoksAccessGroupRef:
description: Salto KS access group reference.
nullable: true
type: string
format: uuid
schedule:
description: Availability schedule.
type: object
properties:
default:
type: object
properties:
closedDays:
type: array
items:
type: string
description: Dates in MM-DD format when the resource is closed.
items:
type: array
items:
type: object
properties:
days:
type: object
properties:
friday:
type: boolean
description: >-
Whether Friday is included in this schedule
window.
monday:
type: boolean
description: >-
Whether Monday is included in this schedule
window.
saturday:
type: boolean
description: >-
Whether Saturday is included in this schedule
window.
sunday:
type: boolean
description: >-
Whether Sunday is included in this schedule
window.
thursday:
type: boolean
description: >-
Whether Thursday is included in this schedule
window.
tuesday:
type: boolean
description: >-
Whether Tuesday is included in this schedule
window.
wednesday:
type: boolean
description: >-
Whether Wednesday is included in this schedule
window.
required:
- friday
- monday
- saturday
- sunday
- thursday
- tuesday
- wednesday
additionalProperties: false
description: Weekdays this time window applies to.
hours:
type: object
properties:
from:
type: string
description: Opening time in 24-hour "HH:mm" format.
to:
description: >-
Closing time in 24-hour format, counted from
the start of the weekday. A day that stays
open past midnight closes after 24:00, for
example at 26:00 for 2:00 AM the next day, and
at most 24 hours after the opening time.
type: string
required:
- from
- to
additionalProperties: false
description: Open hours for the selected weekdays.
required:
- days
- hours
additionalProperties: false
description: Weekly availability windows for members.
required:
- closedDays
- items
additionalProperties: false
description: Default availability schedule.
enabled:
type: boolean
description: Whether scheduling is enabled.
public:
type: object
properties:
closedDays:
type: array
items:
type: string
description: >-
Dates in MM-DD format when the resource is closed for
public bookers.
enabled:
type: boolean
description: Whether the public schedule is enabled.
items:
type: array
items:
type: object
properties:
days:
type: object
properties:
friday:
type: boolean
description: >-
Whether Friday is included in this schedule
window.
monday:
type: boolean
description: >-
Whether Monday is included in this schedule
window.
saturday:
type: boolean
description: >-
Whether Saturday is included in this schedule
window.
sunday:
type: boolean
description: >-
Whether Sunday is included in this schedule
window.
thursday:
type: boolean
description: >-
Whether Thursday is included in this schedule
window.
tuesday:
type: boolean
description: >-
Whether Tuesday is included in this schedule
window.
wednesday:
type: boolean
description: >-
Whether Wednesday is included in this schedule
window.
required:
- friday
- monday
- saturday
- sunday
- thursday
- tuesday
- wednesday
additionalProperties: false
description: Weekdays this time window applies to.
hours:
type: object
properties:
from:
type: string
description: Opening time in 24-hour "HH:mm" format.
to:
description: >-
Closing time in 24-hour format, counted from
the start of the weekday. A day that stays
open past midnight closes after 24:00, for
example at 26:00 for 2:00 AM the next day, and
at most 24 hours after the opening time.
type: string
required:
- from
- to
additionalProperties: false
description: Open hours for the selected weekdays.
required:
- days
- hours
additionalProperties: false
description: Weekly availability windows for public bookers.
required:
- closedDays
- enabled
- items
additionalProperties: false
description: Public availability schedule.
required:
- default
- enabled
- public
additionalProperties: false
tapkeyGroupRef:
description: Tapkey access group reference.
nullable: true
type: string
format: uuid
title:
type: string
description: Display name of the resource.
type:
type: string
enum:
- dedicatedDesk
- equipment
- hotDesk
- office
- parkingLot
- room
- station
- conferenceRoom
- eventSpace
- meetingRoom
- phoneBooth
- studio
description: Type of the resource.
unifiAccessGroupRef:
description: UniFi Access policy reference.
nullable: true
type: string
visibility:
type: string
enum:
- admins
- exclusiveMembers
- members
- networkMembers
- public
description: Visibility of the resource.
required:
- assignments
- bookingPermission
- bookingUnit
- bufferTime
- children
- confirmationEmail
- createDate
- credits
- description
- duration
- dynamicPricing
- id
- locale
- locationRef
- media
- money
- networkRef
- preparationMinutes
- refundThreshold
- title
- type
- visibility
required:
- resource
additionalProperties: false
responseError:
type: object
properties:
message:
type: string
type:
type: string
securitySchemes:
BasicAuth:
type: http
description: >-
See our [authentication
documentation](https://www.spacebring.com/docs/developer/api/authentication#basic-authentication)
for how to authorize your requests
scheme: basic
OAuth2:
type: oauth2
description: >-
See our [authentication
documentation](https://www.spacebring.com/docs/developer/api/authentication#oauth2)
for how to authorize your requests
flows:
authorizationCode:
authorizationUrl: https://api.spacebring.com/oauth2/authorize
tokenUrl: https://api.spacebring.com/oauth2/token
refreshUrl: https://api.spacebring.com/oauth2/token
scopes:
benefits.readonly: Read benefits and applications
benefits: Read and write benefits and applications
checkIns.readonly: Read check-ins
checkIns: Read and write check-ins
community.readonly: Read community companies and memberships
community: Read and write community companies and memberships
events.readonly: Read events and tickets
events: Read and write events and tickets
feed.readonly: Read feed posts
feed: Read and write feed posts
invoices.readonly: Read contracts, credit notes, discounts and invoices
invoices: Read and write contract, credit notes, discounts and invoices
locations.readonly: Read locations
locations: Read and write locations
plans.readonly: Read plans
plans: Read and write plans
resources.readonly: Read resources and bookings
resources: Read and write resources and bookings
subscriptions.readonly: Read subscriptions
subscriptions: Read and write subscriptions
shop.readonly: Read products and orders
shop: Read and write products and orders
support.readonly: Read support tickets
support: Read and write support tickets
transactions.readonly: Read transactions
transactions: Read and write transactions
visitors.readonly: Read visitors
visitors: Read and write visitors
````