Update asset

post

https://your-protect-instance.example.com/api/rest/v2/assets/{assetID}/update

Starts an asynchronous update-asset operation. Returns the operation in PENDING; poll GetAssetOperationV2 for terminal status. On-chain token properties are applied via an approved on-chain update; the off-chain label is applied on completion, and a non-empty price triggers a separate asynchronous admin price change that this operation does not wait for. GetAssetV2 reflects the new on-chain values once the operation completes.

Path Params

assetID

string

required

The v2 asset id (AssetView id) to update. Required; the asset must be ACTIVE.

Body Params

UpdateAssetRequestV2 updates an existing asset: an on-chain change (params)
plus optional off-chain label/price metadata.

fromAddressID

string

The source address that submits and funds the on-chain update — an internal address holding this asset's token. Required.

label

string

New off-chain platform display label. Optional.

price

string

New price. Optional. If set, triggers a separate, asynchronous admin price-change request that this operation does not wait for.

params

object

UpdateAssetParamsV2 mirrors AssetParamsV2's shape so callers learn one
pattern. Branches for chains that don't support update today are empty
messages; populating them later is non-breaking.
UpdateAssetParamsV2 is the per-chain on-chain update payload — the typed
change applied to the token.

Responses

200A successful response.

400Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)

401Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource

403Forbidden: indicates that the server understands the request but refuses to authorize it

404Not Found: indicates that the server cannot find the requested resource

500Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request

503Service Unavailable: indicates that the server is not ready to handle the request.

defaultAn unexpected error response.