AssetCenter
Sign in Get started - it's free!

↑ ↓ to navigate · ↵ to open See all results
PATCH /api/v1/asset-categories/{category}

Update an asset category

Update the supplied category settings while preserving omitted values.

Last updated

Request

PATCH /api/v1/asset-categories/{category}

Requires asset-categories:update. The token creator must remain an active administrator of the token’s organization. Category permissions.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

category is the numeric ID of an asset category in the token’s organization. Subscription categories are unavailable here.

Query parameters

This endpoint does not use query parameters.

Request body

Provide at least one listed field. PATCH changes only supplied fields; omitted values are preserved.

Field Type Required Description
name string No The category name, up to 255 characters. Must be unique among asset categories in this organization.
description string or null No An optional description, up to 10,000 characters. Send null to clear it.
end_of_life integer or null No Expected end of life in months: 1–12,000. Send null to clear it.
useful_life integer or null No Useful life for depreciation in years: 1–1,000. Send null to clear it.
eol_lookahead_days string No End-of-life notification window. Use a value from notification_options in the options endpoint. Defaults to dont_notify on creation; null is invalid.
warranty_lookahead_days string No Warranty notification window. Uses the same notification_options values. Defaults to dont_notify on creation; null is invalid.

Requires Idempotency-Key. Generate one key per action and keep it for retries. Successful responses are remembered for 24 hours per token. Idempotency and retries.

Example

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example IDs with values from your organization. For a retry, reuse the original key instead of generating another UUID.

cURL / Bash 
curl --request PATCH "https://my.assetcenter.app/api/v1/asset-categories/7" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --header "Content-Type: application/json" \
  --data '{"end_of_life":60,"useful_life":5}'

Response

200 OK. Illustrative response; IDs and values will differ.

JSON 
{
  "data": {
    "id": 7,
    "name": "Vehicles",
    "description": null,
    "end_of_life": 60,
    "useful_life": 5,
    "eol_lookahead_days": "dont_notify",
    "warranty_lookahead_days": "dont_notify",
    "can_delete": true,
    "custom_fields": [
      {
        "id": 31,
        "category_id": 7,
        "name": "Registration",
        "type": "text",
        "is_required": false,
        "has_values": false,
        "can_delete": true,
        "can_change_type": true
      }
    ]
  }
}

The category has the fields described in Get an asset category. Use the returned category ID as category_id when creating an asset.

Behavior and constraints

Category names must be unique among asset categories in this organization. Description and both lifecycle values can be cleared with null. Notification settings cannot be null; use dont_notify to disable them. Category type, organization, display order, and custom fields cannot be set here. Use the dedicated field endpoints to edit definitions.

Errors

401 means the customer bearer token is missing, expired, revoked, or invalid. 403 means the required permission is missing or the token creator is no longer an active organization administrator. 404 means the category or field is unavailable in this organization. 422 identifies invalid or unsupported input. 429 means a rate limit was reached. Error handling and rate limits. 409 means conflicting key reuse or a data constraint described above.