> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Asset statuses

> Track where each asset is in its lifecycle with statuses grouped into four categories, a default status, and automatic changes on assignment.

Every asset has a **Status** that shows where it is in its lifecycle, such as In Stock, In Use, or Retired. Statuses are shared by every asset type in your organization, and each one belongs to a fixed category that drives automatic changes when assets are assigned.

## Status model

* Statuses are organization-wide and shared by every asset type.
* Categories are fixed: AVAILABLE, IN\_USE, UNAVAILABLE, RETIRED. Filter by category to answer questions across renamed statuses.
* Seeded statuses: In Stock (AVAILABLE, blue, default), In Use (IN\_USE, green), In Repair (UNAVAILABLE, amber), Retired (RETIRED, gray). Labels and colors are admin-editable.
* Exactly one status is the default. It cannot be archived.

***

## Constraints and gotchas

* Unassigning only returns an asset to the default status when the default is in the Available category.
* An explicit status in the same change as an assignment wins over the automatic move.
* Retire, don't archive, to take an asset out of circulation and keep its record visible.


## Related topics

- [List asset statuses](https://docs.ravenna.ai/api/assets/list-asset-statuses.md)
- [Reorder asset statuses](https://docs.ravenna.ai/api/assets/reorder-asset-statuses.md)
- [Archive an asset status](https://docs.ravenna.ai/api/assets/archive-an-asset-status.md)
- [Available tools](https://docs.ravenna.ai/documentation/automate/mcp/tools.md)
- [Create an asset status](https://docs.ravenna.ai/api/assets/create-an-asset-status.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.