Skip to navigation
TOKEN ISSUANCE AND ASSET SERVICINGAssetV2

Mint tokens

Starts a mint operation for the given asset.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

assetIDstringRequired

Request

This endpoint expects an object.
fromAddressIDstringOptionalformat: "uint64"
destinationobjectOptional

AddressTargetV2 names an address as either an internal address (managed by the platform) or a whitelisted external address. Exactly one variant must be set. Replaces v1's paired uint64 fields where mutual exclusion was a runtime invariant.

amountstringOptional
nftMetadatalist of stringsOptional

Response

A successful response.
idstringOptional
assetIDstringOptional
typeenumOptional
statusenumOptional

AssetOperationStatusV2 is the consumer-facing lifecycle status of an operation. Two non-terminal values:

  • PENDING: system is making progress automatically; consumer should wait.
  • PAUSED: action required from the operation initiator (or an operator) before progress can resume — see AssetOperationV2.blockingReason for the machine-readable cause. Three terminal values: COMPLETED, FAILED, CANCELED.
Allowed values:
createdAtdatetimeOptional
updatedAtdatetimeOptional
initiatedByAddressIDstringOptionalformat: "uint64"
Internal address that initiated this operation.
failureReasonenumOptional

AssetOperationFailureReasonV2 is the machine-readable cause when an operation reaches the FAILED terminal status. Free-form failure messages are not surfaced on the wire; consumers should switch on this enum. Two-tier: UNSPECIFIED means not failed; UNKNOWN is the catch-all for failed-with-no-typed-code; specific reasons grow as concrete cases are wired through from the underlying workflows.

  • ASSET_OPERATION_FAILURE_REASON_V2_UNKNOWN: Failed, but no typed code is available
  • ASSET_OPERATION_FAILURE_REASON_V2_INTERNAL_ERROR: Specific: a system/internal error occurred.
  • ASSET_OPERATION_FAILURE_REASON_V2_REQUEST_REJECTED: The underlying approval request was rejected by an approver.
  • ASSET_OPERATION_FAILURE_REASON_V2_REQUEST_FAILED: The underlying request terminated in failure for some non-rejection reason (expired, timed out, on-chain failure, ...).
  • ASSET_OPERATION_FAILURE_REASON_V2_SOURCE_ADDRESS_ON_INVALID_CURRENCY: The source address passed to the operation is registered for a different currency than the asset. One must retry with the address tied to the asset's currency.
  • ASSET_OPERATION_FAILURE_REASON_V2_SOURCE_ADDRESS_NOT_ASSET_ISSUER: The source address isn't the asset's on-chain issuer (the per-chain name varies. Only the issuer can mint or burn the asset.
blockingReasonenumOptional

AssetOperationBlockingReasonV2 is the machine-readable cause when an operation is in the PAUSED non-terminal status. Distinct from FailureReason: a paused operation is alive and resumable once the blocker is cleared. Two-tier same as FailureReason: UNSPECIFIED means not paused; UNKNOWN is the catch-all for paused-with-no-typed-code; specific reasons grow as concrete cases land.

  • ASSET_OPERATION_BLOCKING_REASON_V2_UNKNOWN: Paused, but no typed code is available.
  • ASSET_OPERATION_BLOCKING_REASON_V2_MISSING_GOVERNANCE_RULE: Governance rule missing to complete the operations.
  • ASSET_OPERATION_BLOCKING_REASON_V2_MANUAL_PAUSE: Operation has been manually paused.
  • ASSET_OPERATION_BLOCKING_REASON_V2_AWAITING_REQUEST_APPROVAL: Awaiting human approval on a deployment / mint / burn / etc. request (the HandleRequestWorkflow's PENDING state).
  • ASSET_OPERATION_BLOCKING_REASON_V2_AWAITING_WHITELIST_APPROVAL: Awaiting approval of a whitelisted-address record for the asset.
  • ASSET_OPERATION_BLOCKING_REASON_V2_AWAITING_CURRENCY_PRICE: Operation blocked because no price is set for the asset's currency.
  • ASSET_OPERATION_BLOCKING_REASON_V2_AWAITING_MANUAL_WHITELIST: The auto-generated whitelist proposal was rejected by an approver; the asset is on-chain but the workflow waits for someone to manually create + approve a whitelist (which resumes the flow).
createobjectOptional
updateobjectOptional
importobjectOptional
mintobjectOptional
burnobjectOptional
pauseobjectOptional
unpauseobjectOptional
pauseAccountobjectOptional
unpauseAccountobjectOptional
setKycobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
503
Service Unavailable Error