Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
ItManagement > ItAsset

Updates an It asset

Updates an It asset

put/api/2026-07-01/resources/it_management/it_assets/{id}

Path parameters

idstring required

IT Asset identifier

Request body

idstring required

IT Asset identifier

it_asset_model_idstring

IT Asset Model identifier (Endpoints related to ItManagement/it_asset_models).

serial_numberstring

Serial number of the IT asset

statusstring

Status of the IT asset. Possible values:

  • assigned: Asset is assigned to an employee
  • in_stock: Asset is available in inventory
  • maintenance: Asset is under maintenance or repair
  • retired: Asset has been retired or decommissioned

Note: Not all status transitions are allowed. For example, an asset cannot be directly changed from assigned or in_stock to certain other statuses without proper workflow validation.

owner_idstring

Owner (employee) identifier

location_idstring

Space identifier

workplace_idstring

Workplace identifier

team_idstring

Team identifier

purchase_datestring

Purchase date of the IT asset (YYYY-MM-DD)

purchase_price_centsinteger

Purchase price in cents

currencystring

Currency of the purchase price

warranty_end_datestring

Warranty end date of the IT asset (YYYY-MM-DD)

labelstring

Label of the IT asset

notesstring

Notes about the IT asset

company_idstring

Company identifier

Example request

{
  "id": "0199e6ea-20c0-73d3-9782-8267dc96773a",
  "it_asset_model_id": "0199e6ea-20c0-73d3-9782-8267dc96773a",
  "serial_number": "SN123456789",
  "status": "maintenance",
  "purchase_date": "2024-01-01",
  "purchase_price_cents": 100000,
  "currency": "EUR",
  "warranty_end_date": "2027-01-01",
  "company_id": "1"
}

Response

OK

idstring required

IT Asset identifier

company_idstring required

Company identifier

it_asset_model_idstring required

IT Asset Model identifier

serial_numberstring required

Serial number of the IT asset

statusstring required

Status of the IT asset. Possible values:

  • assigned: Asset is assigned to an employee
  • in_stock: Asset is available in inventory
  • maintenance: Asset is under maintenance or repair
  • retired: Asset has been retired or decommissioned

Note: Not all status transitions are allowed. For example, an asset cannot be directly changed from assigned or in_stock to certain other statuses without proper workflow validation.

owner_idstring

Owner (employee) identifier

location_idstring

Location identifier

workplace_idstring

Workplace identifier

team_idstring

Team identifier

purchase_datestring

Purchase date of the IT asset

purchase_price_centsinteger

Purchase price in cents

currencystring

Currency of the purchase price

warranty_end_datestring

Warranty end date of the IT asset

labelstring

Label of the IT asset

notesstring

Notes about the IT asset

created_atstring required

Creation date of the IT asset

updated_atstring required

Last update date of the IT asset

discarded_atstring

Timestamp when the IT asset was soft deleted

Example response

{
  "id": "0199e6ea-20c0-73d3-9782-8267dc96773a",
  "company_id": "1",
  "it_asset_model_id": "0199e6ea-20c0-73d3-9782-8267dc96773a",
  "serial_number": "SN123456789",
  "status": "in_stock",
  "owner_id": "1",
  "purchase_date": "2024-01-01",
  "purchase_price_cents": 100000,
  "currency": "EUR",
  "warranty_end_date": "2027-01-01",
  "label": "Internal asset label",
  "notes": "This field is for custom data related to the asset",
  "created_at": "2024-01-20T18:05:45.000Z",
  "updated_at": "2024-01-20T18:05:45.000Z",
  "discarded_at": "2024-01-20T18:05:45.000Z"
}