Retire Asset

Mark an asset as retired and remove any assignment.

POST

/api/v1/assets/{id}/retire

Description

Sets the asset status to Retired and clears the current employee assignment. No request body is required. Use serial number, customer asset ID, internal ID, or asset number as the id.

Request

Headers

Header	Value	Required
Authorization	Bearer <access_token>	Yes
Content-Type	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Serial number, customer asset ID, internal ID, or asset number.

Response

Field	Type	Description
message	string	Human-readable confirmation.

Related Endpoints

Update Asset

Update asset fields

Did this page help you?

Request

curl -X POST https://uat.unduit.com/api-exposed/api/v1/assets/C02XK1ABCDEF/retire \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Success Response

{
  "message": "Asset retired successfully."
}