# Asset Management

Manage company-owned hardware inventory scoped to a workspace. Includes asset CRUD with property and custom-field support, asset type definitions (system + workspace-custom), and custom field definitions (text, number, date, checkbox, dropdown).

 - [GET /assets](https://api-docs.webwork-tracker.com/api/asset-management/getassets.md): Retrieve a paginated list of assets in the specified workspace. Each asset is returned with its denormalized relationships: assigned user (with email and full name), creator, asset type, and any custo
 - [POST /assets](https://api-docs.webwork-tracker.com/api/asset-management/createasset.md): Create a new asset in the workspace. Required fields are `workspace_id`, `category`, and `name`. Optional fields include `type_id` (encrypted asset type), `brand`, `model`, `notes`, free-form `propert
 - [GET /assets/{asset_id}](https://api-docs.webwork-tracker.com/api/asset-management/getasset.md): Retrieve a single asset by its encrypted ID. Returns the asset with denormalized relationships: assigned user (with email and full name), creator, asset type, and custom field values keyed by slug. **
 - [PUT /assets/{asset_id}](https://api-docs.webwork-tracker.com/api/asset-management/updateasset.md): Update an existing asset. Editable fields include `name`, `brand`, `model`, `notes`, `type_id`, free-form `properties`, and `custom_fields` (keyed by slug). The `category` field is immutable once set
 - [DELETE /assets/{asset_id}](https://api-docs.webwork-tracker.com/api/asset-management/deleteasset.md): Soft-delete an asset. The asset is marked deleted but preserved for audit and can be brought back via POST /assets/{asset_id}/restore. Any current assignment is cleared. **Access**: Plus plan + Owner/
 - [POST /assets/{asset_id}/restore](https://api-docs.webwork-tracker.com/api/asset-management/restoreasset.md): Restore a previously soft-deleted asset, making it active again. Returns 422 if the asset is not currently deleted. **Access**: Plus plan + Owner/Executive Manager.
 - [POST /assets/{asset_id}/assign](https://api-docs.webwork-tracker.com/api/asset-management/assignasset.md): Assign an asset to a workspace user. The target user must belong to the same workspace. Re-assigning replaces the previous assignee. **Access**: Plus plan + Owner/Executive Manager.
 - [POST /assets/{asset_id}/unassign](https://api-docs.webwork-tracker.com/api/asset-management/unassignasset.md): Clear the current assignee of an asset. Idempotent: succeeds even if the asset is already unassigned. **Access**: Plus plan + Owner/Executive Manager.
 - [GET /asset-types](https://api-docs.webwork-tracker.com/api/asset-management/getassettypes.md): List all asset types available to the workspace. The result combines built-in **system** types (e.g. `Laptop`, `Phone`, `Router`) with workspace-defined custom types. Use the `category` filter to narr
 - [POST /asset-types](https://api-docs.webwork-tracker.com/api/asset-management/createassettype.md): Create a new workspace-custom asset type within the given category. The type will have `is_system: false` and is editable/deletable by the workspace. The `name` must be unique within the workspace+cat
 - [GET /asset-types/{type_id}](https://api-docs.webwork-tracker.com/api/asset-management/getassettype.md): Retrieve a single asset type by its encrypted ID. Both system and workspace-custom types are accessible. **Access**: Plus plan + Owner/Executive Manager.
 - [PUT /asset-types/{type_id}](https://api-docs.webwork-tracker.com/api/asset-management/updateassettype.md): Rename a workspace-custom asset type. Returns 403 if the target type is a system type (system types are read-only). The new name must be unique within the same workspace+category. **Access**: Plus pla
 - [DELETE /asset-types/{type_id}](https://api-docs.webwork-tracker.com/api/asset-management/deleteassettype.md): Delete a workspace-custom asset type. Returns 403 for system types. Returns 409 if any asset currently references this type, with `in_use_count` indicating how many; reassign or delete those assets fi
 - [GET /asset-custom-fields](https://api-docs.webwork-tracker.com/api/asset-management/getassetcustomfields.md): List all custom field definitions for the workspace. Custom fields let you attach typed metadata (text, number, date, checkbox, dropdown) to assets. Use the optional `category` filter to retrieve only
 - [POST /asset-custom-fields](https://api-docs.webwork-tracker.com/api/asset-management/createassetcustomfield.md): Define a new custom field for assets. The `slug` is auto-derived from `name` (lowercase, dash-separated) if omitted, and is the key used when sending values via `custom_fields` on the assets endpoints
 - [GET /asset-custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/asset-management/getassetcustomfield.md): Retrieve a single custom field definition by its encrypted ID. **Access**: Plus plan + Owner/Executive Manager.
 - [PUT /asset-custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/asset-management/updateassetcustomfield.md): Update a custom field definition. The `type` is **immutable**: any attempt to change it returns 422. For dropdown fields you may add/edit/remove `options`. **Access**: Plus plan + Owner/Executive Mana
 - [DELETE /asset-custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/asset-management/deleteassetcustomfield.md): Delete a custom field definition. **All values stored under this field on every asset are also deleted (cascade)**. This is irreversible. **Access**: Plus plan + Owner/Executive Manager.