---
title: "Update an asset"
method: PATCH
path: "/v1/assets/{asset_id}"
tags: ["assets"]
---

# Update an asset

`PATCH /v1/assets/{asset_id}`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/assets/{asset_id}`
- Auth: none declared

Update an asset (e.g. its tier).

Args:
    asset_id (int): Primary key of the asset.
    body (UpdateAssetRequest): Partial asset update payload.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.

Returns:
    SuccessResponse: The pre-rename update envelope.

## Path parameters

- `asset_id` integer, required

## Request body

- UpdateAssetRequest: Request body for asset updates. Matches api-3's ``UpdateAsset`` schema — currently only ``tier`` is updatable through the public API. Attributes: tier (AssetTier | None): New tier value.
  - `tier` 'low' | 'medium' | 'high': Tier (importance level) of an asset. Stored as the lowercase token (``low``/``medium``/``high``) — the same value the public API uses, so no wire<->storage mapping is needed.

## Response `200`

Successful Response

- SuccessResponse: Standard response for successful write operations. Matches the ``SuccessResponse`` contract from api-3. Attributes: code (int): HTTP status code. description (str): Human-readable result description. id (int | str | None): Created/affected resource ID. success (bool): Always ``True`` for successful responses.
  - `code` integer, required
  - `description` string, required
  - `id` union
    - integer
    - string
  - `success` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)