AssetCenter
Asset categories and custom fields
Manage asset category settings and field definitions with organization-scoped public API keys.
Last updated
Category management
Use https://my.assetcenter.app/api/v1/asset-categories to manage the asset categories belonging to your API key’s organization. The token creator must remain an active organization administrator. Existing keys keep their current permissions; create a replacement key to grant newly available access.
| Permission | Allows |
|---|---|
asset-categories:read |
List categories, read a category with its fields, and get valid options. |
asset-categories:create |
Create categories and custom-field definitions. |
asset-categories:update |
Edit category settings and field definitions. |
asset-categories:delete |
Delete unused categories and fields. |
Permissions are independent. Asset record permissions do not grant category management. New Read Only tokens include category read access; new Full Access tokens include all four category permissions. Use Custom to select individual permissions.
Endpoints
- List categories and read category details.
- Get notification and field-type options.
- Create, update, or delete a category.
- Create, update, or delete a custom field.
All writes require an Idempotency-Key and support 24-hour replay. PATCH changes only supplied fields. Lists accept page and per_page; the other endpoints accept no query parameters.
Asset values and data protections
Category detail responses include field definitions, without asset values. Use the returned category and field IDs to create assets or update their values. End-of-life values use months; useful life uses years. Checkbox fields are always optional.
Deleting a category is blocked while any asset uses it or its custom fields retain populated values. Fields with values cannot be deleted or change type; labels and requirements remain editable. Retained values include those left by assets that changed category. The response flags describe data constraints, not permission grants.
Subscription categories and display ordering are outside this API. Manage them in the app.