Added
Asset status groups API
July 1st, 2026
This changelog entry was added retrospectively.
A new asset status groups API is available for creating and managing the status taxonomy assets can use.
| Endpoint name | Endpoint |
|---|---|
| Create a status group | POST /assets/v1/status-groups |
| Get a status group | GET /assets/v1/status-groups/{id} |
| Update a status group | PATCH /assets/v1/status-groups/{status_group.id} |
| Delete a status group | DELETE /assets/v1/status-groups/{id} |
| List status groups | POST /assets/v1/status-groups/list |
| Add a status group to asset types | POST /assets/v1/status-groups/{id}/types |
| Remove a status group from asset types | DELETE /assets/v1/status-groups/{id}/types |
Developer impact: Define status groups (for example, "In use," "Under repair," "Retired"), assign them to asset types, then use the resulting status_option_id values to set status via CreateAsset, BulkCreateAssets, or UpdateAsset. Read endpoints require the "Assets: Access" permission, while write endpoints require "Assets: Settings" permission.
Action required: No action required. To get started, create a status group and assign it to an asset type.