Skip to main content
PUT
/
tenant
/
{tenantId}
/
admin
/
assets
/
configuration
Update Tenant Asset Configuration
curl --request PUT \
  --url https://api.example.com/tenant/{tenantId}/admin/assets/configuration \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetIds": [
    1,
    2,
    3
  ]
}
'
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Approves a set of assets for use by a tenant, enabling those assets for the tenant’s blockchain operations. This operation replaces the existing approved assets list with the provided asset identifiers.

​
Input

Expects a JSON body containing:
  • assetIds (array of long, required) - Array of asset identifiers to approve for the tenant.
Path parameter:
  • tenantId (long, required) - The unique identifier of the tenant.

​
Output

Returns an EmbeddedAssetListModel containing:
  • tenantId (string) - The tenant identifier.
  • assets (array) - Updated list of all assets available to the tenant.

​
Examples

Request 
PUT /api/tenant/1024/admin/assets/configuration
{
  "assetIds": [1, 2, 3]
}
Response (200 OK) 
{
  "tenantId": "1024",
  "assets": [
    {
      "id": 1,
      "name": "USD Coin",
      "code": "USDC",
      "country": "United States",
      "numCode": 840,
      "minorUnits": "cents",
      "isAvailable": true,
      "isHistorical": false
    },
    {
      "id": 2,
      "name": "Tether USD",
      "code": "USDT",
      "country": "United States",
      "numCode": 840,
      "minorUnits": "cents",
      "isAvailable": true,
      "isHistorical": false
    }
  ]
}

​
Errors

  • 400 Bad Request: The request parameters failed validation or asset IDs are invalid.
  • 401 Unauthorized: The caller is not authenticated.
  • 403 Forbidden: The caller is not authorized to update asset configurations.
  • 404 Not Found: The tenant or one or more assets could not be found.
  • 500 Internal Server Error: An unexpected server error occurred.

​
Notes

This operation replaces the entire approved assets list. Any previously approved assets not included in the request will be removed from the approved list.

Path Parameters

​
tenantId
integer<int64>
required

The unique identifier of the tenant.

Query Parameters

​
api-version
string | null

Body

application/json

Request containing the array of asset identifiers to approve.

Request to update tenant asset configuration by approving assets.

​
assetIds
integer<int64>[]

Array of asset identifiers to approve for the tenant.

Example:
[1, 2, 3]

Response

Asset configuration updated successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.

Example:
{
  "tenantId": "1024",
  "assets": [
    {
      "id": 1,
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "isAvailable": true
    },
    {
      "id": 2,
      "name": "Ethereum",
      "symbol": "ETH",
      "decimals": 18,
      "isAvailable": true
    }
  ]
}