Naar navigatie springen
ReceptionAssets

Create Asset

Create a bookable asset, such as a room or a piece of equipment.

Headers

xi-api-keystringOptioneel
xi-workspace-idstring or nullOptioneel
The customer workspace a reseller's API key acts on.

Verzoek

This endpoint expects an object.
namestringVerplicht

Internal/admin name of the asset, shown in the dashboard and owner notifications.

groupslist of objectsOptioneel

Group memberships for this item. Each entry carries the group label and the item’s 0-based rank within that group.

ungrouped_rankinteger or nullOptioneel>=0

Display position among items with no group; null sorts last. Change it with the reorder endpoint.

descriptionstringOptioneel
Description of the asset.
is_activebooleanOptioneelStandaard true
Whether the asset can be booked. Inactive assets keep their booking history.
available_hoursobject or nullOptioneel

Custom availability hours for this asset. Null means follow the assigned location’s operating_hours (requires location_id).

photo_urlstring or nullOptioneelformaat: "uri"1-2083 characters
URL of a photo of the asset.
location_idstring or nullOptioneel

Location this asset belongs to; empty means available at all locations.

customer_facing_namestringOptioneel

Optional public-facing label. When empty, name is shown to customers too. name stays the internal/admin label used in the dashboard and business-owner notifications.

Response

Geslaagde response
namestring

Internal/admin name of the asset, shown in the dashboard and owner notifications.

_idstring
groupslist of objectsOptioneel

Group memberships for this item. Each entry carries the group label and the item’s 0-based rank within that group.

ungrouped_rankinteger or nullOptioneel>=0

Display position among items with no group; null sorts last. Change it with the reorder endpoint.

descriptionstringOptioneel
Description of the asset.
is_activebooleanOptioneelStandaard true
Whether the asset can be booked. Inactive assets keep their booking history.
available_hoursobject or nullOptioneel

Custom availability hours for this asset. Null means follow the assigned location’s operating_hours (requires location_id).

photo_urlstring or nullOptioneelformaat: "uri"1-2083 characters
URL of a photo of the asset.
location_idstring or nullOptioneel

Location this asset belongs to; empty means available at all locations.

customer_facing_namestringOptioneel

Optional public-facing label. When empty, name is shown to customers too. name stays the internal/admin label used in the dashboard and business-owner notifications.

created_at_unixintegerOptioneel

Unix timestamp (seconds since epoch)

updated_at_unixintegerOptioneel

Unix timestamp (seconds since epoch)

Fouten

422
Unprocessable Entity Error