Get one InventoryAsset

GET

api

spaces

inventoryassets

{id}

Get one InventoryAsset

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/inventoryassets/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/inventoryassets/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/inventoryassets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "BusinessName": "<string>",
  "Name": "<string>",
  "Description": "<string>",
  "Sku": "<string>",
  "ImageFileName": "<string>",
  "NewImageUrl": "<string>",
  "ClearImageFile": true,
  "Value": 123,
  "FloorPlanDeskId": 123,
  "FloorPlanDeskName": "<string>",
  "CoworkerFullNames": "<string>",
  "CoworkerIds": "<string>",
  "CoworkerStartDates": "<string>",
  "CoworkerEndDates": "<string>",
  "ResourceId": 123,
  "ResourceName": "<string>",
  "AssignToType": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

An InventoryAsset is a location-owned physical item, such as a desk, chair, monitor, or printer, tracked at the location, a bookable resource, or a floor-plan desk. Customer assignments are managed as separate CoworkerInventoryAsset records.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the InventoryAsset-Read role.

Path Parameters

integer

required

The Id of the InventoryAsset record to retrieve.

Code Examples

curl -X GET \
  "https://spaces.nexudus.com/api/spaces/inventoryassets/87654321" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/inventoryassets/87654321',
  {
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

const record = await response.json();

import requests

response = requests.get(
    'https://spaces.nexudus.com/api/spaces/inventoryassets/87654321',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)

record = response.json()

Response

200

integer

ID of the location that owns this asset; saving a linked resource or floor-plan desk can replace it with that linked record’s location..

string

Display value for Business.Name..

string

Required display name of the physical asset, such as ‘Standing Desk #3’ or ‘HP LaserJet’..

string

Optional free-text description of the asset..

string

Optional stock-keeping unit code; when provided, it must be unique within the location..

string

Current file name of the image (read-only; upload via the corresponding URL field).

string

URL of a new file to upload as the image.

boolean

Set to true to remove the current image file.

number

Optional monetary value of the asset in the owning location’s currency..

integer

ID of the floor-plan desk linked to this asset; required when AssignToType is FloorPlanItem and it sets the asset’s location from the desk’s floor plan..

string

Display value for FloorPlanDesk.Name..

string

Read-only comma-separated customer names projected from CoworkerInventoryAsset assignment records; change assignments through that entity instead..

string

Read-only comma-separated customer IDs projected from CoworkerInventoryAsset assignment records; change assignments through that entity instead..

string

Read-only comma-separated assignment start dates projected from CoworkerInventoryAsset records; each assignment requires a start date..

string

Read-only comma-separated assignment end dates projected from CoworkerInventoryAsset records; an end date cannot precede its assignment start date..

integer

ID of the bookable resource linked to this asset; required when AssignToType is Resource and it sets the asset’s location to the resource’s location..

string

Display value for Resource.Name..

integer

Determines the asset scope: Location (1) needs no linked resource or desk, Resource (2) requires ResourceId, and FloorPlanItem (3) requires FloorPlanDeskId.. See eInventoryAssetAssignToType enum values: 1 = Location, 2 = Resource, 3 = FloorPlanItem.

integer

Unique record identifier.

string

UUID of the record.

string

Date and time the record was created (ISO 8601).

string

Date and time the record was last updated (ISO 8601).

string

Email of the user who last updated this record.

boolean

Whether the record was recently created.

string

External system identifier.

Example Response

{
  "BusinessId": 0,
  "BusinessName": null,
  "Name": "",
  "Description": null,
  "Sku": null,
  "ImageFileName": null,
  "NewImageUrl": null,
  "ClearImageFile": null,
  "Value": null,
  "FloorPlanDeskId": null,
  "FloorPlanDeskName": null,
  "CoworkerFullNames": null,
  "CoworkerIds": null,
  "CoworkerStartDates": null,
  "CoworkerEndDates": null,
  "ResourceId": null,
  "ResourceName": null,
  "AssignToType": 0,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "InventoryAsset Example",
  "LocalizationDetails": null,
  "CustomFields": null
}

Get one InventoryAsset

curl --request GET \
  --url https://spaces.nexudus.com/api/spaces/inventoryassets/{id} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/spaces/inventoryassets/{id}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/spaces/inventoryassets/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "BusinessId": 123,
  "BusinessName": "<string>",
  "Name": "<string>",
  "Description": "<string>",
  "Sku": "<string>",
  "ImageFileName": "<string>",
  "NewImageUrl": "<string>",
  "ClearImageFile": true,
  "Value": 123,
  "FloorPlanDeskId": 123,
  "FloorPlanDeskName": "<string>",
  "CoworkerFullNames": "<string>",
  "CoworkerIds": "<string>",
  "CoworkerStartDates": "<string>",
  "CoworkerEndDates": "<string>",
  "ResourceId": 123,
  "ResourceName": "<string>",
  "AssignToType": 123,
  "Id": 123,
  "UniqueId": "<string>",
  "CreatedOn": "<string>",
  "UpdatedOn": "<string>",
  "UpdatedBy": "<string>",
  "IsNew": true,
  "SystemId": "<string>"
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Path Parameters

Code Examples

Response

200

​Authentication

​Path Parameters

​Code Examples

​Response

​200

Authentication

Path Parameters

Code Examples

Response

200