Skip to main content
PATCH
/
v1
/
products
/
{product_id}
Error
A valid request URL is required to generate request examples

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Path Parameters

​
product_id
string
required

Unique identifier of the product to update

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

Body

application/json
​
id
string<uuid>

Unique identifier (UUID) of the product in the Boseat system

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

​
reference
string

Internal reference code for the product. Used for integration with external systems, inventory management, or internal tracking. Must be unique within the organization.

Example:

"one-day-pass"

​
name
string

Display name of the product shown to customers in booking interfaces and invoices

Example:

"One Day Pass"

​
description
string

Detailed description of the product explaining what it includes, duration, and any special terms or conditions

Example:

"Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM."

​
currency
enum<string>
default:EUR

Currency code for the product price. Only EUR is supported.

Available options:
EUR
Example:

"EUR"

​
type
enum<string>

Type of product pricing model. ONE_TIME for single purchases, SUBSCRIPTION for recurring billing.

Available options:
one_time,
recurring
Example:

"one_time"

​
category
enum<string>

Category of the product determining its usage. BOOKING products are used for space reservations, ADDITIONAL products are supplementary services.

Available options:
booking,
additional
Example:

"booking"

​
metadata
object

Product-specific metadata containing configuration and rules. For BOOKING products, must include durationType ("hourly", "daily", "weekly", "monthly") and durationValue (number > 0). For ADDITIONAL products, metadata is optional and can be empty.

Example:
{
  "durationType": "daily",
  "durationValue": 1
}
​
spaces
string[] | null

List of space IDs where this product is available for booking. Use null to indicate the product is available for all spaces (booking products only). Use an empty array [] to indicate no spaces are assigned yet or for additional products not tied to specific spaces.

Example:
[
  "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
  "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
]

Response

Product updated successfully. Check the Location header for the resource location.