Skip to main content
GET
/
platform
/
admin
/
tenant
/
wallets
/
multisignature
/
{walletTenantId}
/
update_threshold
Get threshold update data
curl --request GET \
  --url https://api.example.com/platform/admin/tenant/wallets/multisignature/{walletTenantId}/update_threshold
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

Description

Fetches the current threshold configuration and constraints for a multisignature wallet. This information is needed to validate and prepare a threshold change proposal.

Input

  • walletTenantId (long, required) - The multisignature wallet tenant identifier

Output

Returns an containing:
  • walletTenantId (long) - The wallet tenant identifier
  • currentThreshold (int) - Current signature threshold requirement
  • ownersCount (int) - Total number of current owners
  • minimumThreshold (int) - Minimum allowed threshold value (typically 1)
  • maximumThreshold (int) - Maximum allowed threshold value (equals ownersCount)

Examples

Request
GET /api/platform/wallets/3001/threshold
Response (200 OK)
{
  "walletTenantId": 3001,
  "currentThreshold": 2,
  "ownersCount": 3,
  "minimumThreshold": 1,
  "maximumThreshold": 3
}

Errors

  • 400 Bad Request: Invalid wallet tenant identifier format.
  • 401 Unauthorized: Authentication token is missing or invalid.
  • 403 Forbidden: User does not have permission to view threshold data.
  • 404 Not Found: Wallet does not exist or is not a multisignature wallet.
  • 500 Internal Server Error: An unexpected error occurred while retrieving threshold data.

Notes

The threshold must always be between 1 and the total number of owners. This endpoint provides the constraints needed for the UI to validate threshold change requests before submission.

Path Parameters

walletTenantId
integer<int64>
required

Identifier of the wallet tenant.

Query Parameters

api-version
string | null

Response

Threshold update data retrieved 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.