# Equipment

## Get filtered assets

 - [POST /api/v1/assets](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets/post.md): This endpoint returns a list of assets associated with the current account
based on the filters specified in the request body.

Behavior:

- Results are scoped to the current account context
- Supports filtering and search based on asset attributes
- Only assets accessible to the user are returned

## Add new general asset

 - [POST /api/v1/assets/general/add](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1add/post.md): Creates a new general asset within the current account context using the provided request data.
            
Behavior:
- Validates manage privilege for equipment
- Creates a new general asset record
- Associates the asset with the current account and user
- Returns the created asset details
- Logs the action as an equipment added event

## Update existing general asset

 - [POST /api/v1/assets/general/{assetIdentifier}](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetidentifier%7D/post.md): Updates the specified general asset within the current account context using the provided request data.
            
Behavior:
- Validates manage privilege for equipment
- Verifies the asset belongs to the account
- Updates asset details based on request data
- Returns the updated asset information
- Logs the action as an equipment updated event

## Get general asset by ID

 - [GET /api/v1/assets/general/{assetIdentifier}](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetidentifier%7D/get.md): Returns detailed information for the specified general asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Retrieves asset details for the given identifier
- Returns structured general asset response data
- Logs the action as an equipment viewed event

## Remove general asset

 - [POST /api/v1/assets/general/{assetIdentifier}/remove](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetidentifier%7D~1remove/post.md): Removes the specified general asset from the current account context based on the provided request data.
            
Behavior:
- Validates manage privilege for equipment
- Verifies the asset belongs to the account
- Performs asset removal based on request criteria
- Returns removal status details
- Logs the action as an equipment deleted event

## Get general asset types

 - [GET /api/v1/assets/general/assettypes/list](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1assettypes~1list/get.md): Returns the list of general asset types available within the current account context.
            
Behavior:
- Validates manage or view privilege for asset types
- Retrieves all configured general asset types
- Returns structured asset type response data
- Logs the action as an equipment category list view event

## List general asset classes

 - [POST /api/v1/assets/general/assetclass/list](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1assetclass~1list/post.md): Returns a filtered list of general asset classes within the current account context.
            
Behavior:
- Validates manage or view privilege for asset classes
- Applies keyword filtering from the request body
- Retrieves matching general asset classes
- Returns structured asset class response data
- Logs the action as an equipment type list view event

## Get general asset class

 - [GET /api/v1/assets/general/assetclass/{assetClassIdentifier}](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1assetclass~1%7Bassetclassidentifier%7D/get.md): Returns details of the specified general asset class within the current account context.
            
Behavior:
- Validates manage privilege for asset classes
- Verifies the asset class belongs to the account
- Retrieves asset class details by identifier
- Returns structured asset class response data
- Logs the action as an equipment type view event

## List asset classes by type

 - [GET /api/v1/assets/general/assettypes/{assetTypeIdentifier}/assetclass/list](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1assettypes~1%7Bassettypeidentifier%7D~1assetclass~1list/get.md): Returns the list of asset classes associated with the specified general asset type within the current account context.
            
Behavior:
- Validates the asset type belongs to the account
- Retrieves associated asset classes for the given asset type identifier
- Returns structured asset class response data
- Logs the action as an equipment type list view event

## Get paginated asset classes

 - [POST /api/v1/assets/general/assetclass/list/all](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1assetclass~1list~1all/post.md): Returns a filtered and paginated list of general asset classes within the current account context.
            
Behavior:
- Validates manage or view privilege for asset classes
- Applies filtering criteria from the request body
- Supports pagination using the start query parameter
- Retrieves matching asset classes
- Returns structured asset class list response data
- Logs the action as an equipment type list view event

## Get asset tasks

 - [POST /api/v1/assets/{assetId}/tasks](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1%7Bassetid%7D~1tasks/post.md): Returns a filtered and paginated list of tasks associated with the specified asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Applies filtering criteria from the request body
- Supports pagination using the start query parameter
- Retrieves tasks linked to the given asset identifier
- Returns structured task list response data
- Logs the action as a task viewed event

## Get asset warranties

 - [POST /api/v1/assets/general/{assetIdentifier}/warranties](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetidentifier%7D~1warranties/post.md): Returns a filtered and paginated list of warranty documents associated with the specified general asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Applies filtering criteria from the request body
- Supports pagination using the start query parameter
- Retrieves warranty-type operational documents for the asset
- Returns structured operational document list response data
- Logs the action as an equipment warranty list view event

## Get related assets

 - [POST /api/v1/assets/general/{assetIdentifier}/relatedAssets](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetidentifier%7D~1relatedassets/post.md): Returns related assets associated with the specified general asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Applies relation filter from the request body
- Retrieves assets linked to the given asset identifier
- Returns structured related asset response data
- Logs the action as a related asset view event

## Get asset summary

 - [GET /api/v1/assets/{assetIdentifier}/summary](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1%7Bassetidentifier%7D~1summary/get.md): Returns summary details of the specified asset within the current account context.
            
Behavior:
- Validates the asset belongs to the account
- Retrieves summary information for the given asset identifier
- Returns structured asset summary response data
- Logs the action as an asset summary view event

## List basic assets

 - [POST /api/v1/assets/general/list/basic](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1list~1basic/post.md): Returns basic asset details based on the provided portfolio filters.
            
Behavior:
- Applies portfolio filtering criteria
- Supports pagination using the start parameter
- Returns summarized asset tile information
- Logs the action as equipment tile view

## Get asset changesets

 - [POST /api/v1/assets/general/{assetId}/changesets](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1%7Bassetid%7D~1changesets/post.md): Returns the change history of the specified asset based on the provided filters.
            
Behavior:
- Validates the asset belongs to the account
- Applies changeset filtering criteria
- Supports pagination using limit and start parameters
- Retrieves asset change history records
- Logs the action as equipment changeset view

## Get asset grid list

 - [POST /api/v1/assets/general/basic/list](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1basic~1list/post.md): Returns a filtered and paginated grid list of general assets.
            
Behavior:
- Applies portfolio filtering criteria
- Supports pagination using the start parameter
- Retrieves general assets for the account
- Returns structured asset grid response data
- Logs the action as equipment grid view

## Get basic asset nodes

 - [POST /api/v1/assets/nodes/basic](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1nodes~1basic/post.md): Returns child asset nodes based on the provided portfolio filters and asset type.
            
Behavior:
- Applies portfolio filtering criteria
- Filters results using the asset type identifier
- Retrieves child asset node details
- Returns structured asset node response data
- Logs the action as asset child list view

## List general assets

 - [POST /api/v1/assets/general/list](https://zonedevelopersdocumentationv1.redocly.app/apis/equipment/paths/~1api~1v1~1assets~1general~1list/post.md): Returns a filtered and paginated list of general assets for the current account.
            
Behavior:
- Applies portfolio filtering criteria
- Supports pagination using the start parameter
- Retrieves assets accessible to the current user
- Returns structured general asset list response data
- Logs the action as equipment list view