Unassign Asset
Unassign an asset from a user in the Asset Registry system.
POST
/api/v1/assets/unassign/userDescription
This endpoint unassigns an asset from a user. It is used to remove the link between a specific asset and the user it's currently assigned to. Typically used when a user leaves, changes departments, or returns equipment. Asset status must not be set to 'Deployed' in order to unassign the asset.
Request
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| asset_number | string | Yes | The unique ID of the asset to unassign |
| assign_to_email | string | Yes | The email of the user from whom the asset is being unassigned |
| asset_status | string | Yes | Status of the asset post-unassignment (e.g., Ready to Deploy) |
Related Endpoints
Did this page help you?
Request
curl -X POST https://dev-api.unduit.com/api/v1/assets/unassign/user \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"asset_number": "2454820250602045337",
"assign_to_email": "john.doe@example.com",
"asset_status": "Ready to Deploy"
}'Success Response (200)
{
"message": "Asset unassigned successfully."
}Error Responses
400 Bad Request
{
"message": "Invalid asset number or user email"
}401 Unauthorized
{
"message": "Authentication token is missing or invalid"
}404 Not Found
{
"message": "Asset or user not found"
}409 Conflict
{
"message": "Asset is not currently assigned to any user"
}