ナビゲーションにスキップ

Create Asset

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

ヘッダー

xi-api-keystringオプション
xi-workspace-idstring or nullオプション
The customer workspace a reseller's API key acts on.

リクエスト

This endpoint expects an object.
namestring必須

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

groupslist of objectsオプション

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

ungrouped_rankinteger or nullオプション>=0

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

descriptionstringオプション
Description of the asset.
is_activebooleanオプションデフォルト値 true
Whether the asset can be booked. Inactive assets keep their booking history.
available_hoursobject or nullオプション

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

photo_urlstring or nullオプション形式: "uri"1-2083 characters
URL of a photo of the asset.
location_idstring or nullオプション

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

customer_facing_namestringオプション

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.

レスポンス

成功レスポンス。

namestring

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

_idstring
groupslist of objectsオプション

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

ungrouped_rankinteger or nullオプション>=0

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

descriptionstringオプション
Description of the asset.
is_activebooleanオプションデフォルト値 true
Whether the asset can be booked. Inactive assets keep their booking history.
available_hoursobject or nullオプション

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

photo_urlstring or nullオプション形式: "uri"1-2083 characters
URL of a photo of the asset.
location_idstring or nullオプション

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

customer_facing_namestringオプション

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_unixintegerオプション

Unix timestamp (seconds since epoch)

updated_at_unixintegerオプション

Unix timestamp (seconds since epoch)

エラー

422
Unprocessable Entity Error