Inactivate Position

Inactivates the Token Account / Position in the SVM Cluster and on the Vulcan Forge platform. It refunds remaining network currency to the desired destination: the feePayer or a provided itemData.refundDestination wallet.

If there is any token balance left in the position, in order to be able to close the position, this balance needs to be disposed of. The balance can be either burned with itemData.burnRemainingTokenBalance or transferred to another position with itemData.transferRemainingTokenBalanceTo.

If there is a token balance left and the position is frozen, this endpoint can also unfreeze the position in the same transaction by specifying the item.unfreezeIfNeeded = true. Optionally the itemData.freezeAuthority can be set if privateKeyDetails need to be provided for it, otherwise it will be fetched based on the token configuration. Note that the unfreeze option is only available if the financial instrument is a TOKEN_2022 version.

The position can reactivated later with the Initialize Position endpoint.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request PATCH 'https://vf-solana-api.dev.alphaledger.com/api/v1/positions/inactivate?svmCluster=SOLANA_DEVNET' \ --header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "itemData": { "positionToInactivate": { "position": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "owner": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "financialInstrument": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "mintAuthority": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "freezeAuthority": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false } }, "refundNetworkCurrrencyToFeePayer": false, "refundNetworkCurrrencyDestination": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "burnRemainingTokenBalance": false, "transferRemainingTokenBalanceTo": { "position": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "owner": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "financialInstrument": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "mintAuthority": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "freezeAuthority": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false } }, "unfreezeIfNeeded": false, "freezeAuthority": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false } }, "svmTransactionConfig": { "feePayer": { "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton", "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a", "offchainReferences": { "alId": "ALFNDPF000153778", "organizationExternalId": "ALT", "accountNumber": "ALT10000233", "code": "some-authority", "type": "WALLET" }, "autoSign": true, "otherTenantOrganizationExternalId": "ALIM", "offPlatform": false }, "computeUnitConfig": { "enable": true, "limit": 0, "price": 0, "priceEstimate": { "provider": "HELIUS", "calculationStrategy": "DEFAULT", "priorityLevel": "RECOMMENDED" } }, "commitmentConfig": { "commitmentLevel": "processed" }, "messageLifetimeStrategy": "RECENT_BLOCKHASH", "transactionVersion": "V0" }, "tenancyConfig": { "overrideOrganizationExternalId": "ALIM" } }'

{ "success": false, "offchainId": "ee36c656-aa74-4d6a-b23c-332c204cb202", "status": "SIGNED", "onchainId": "5nwo7XvhiVRpJasEzH5r3hGKJqaTxd7qVit3cedFJgESdAPrmawebMJu6fUKRfjXEaivuey7vBsW56xPxX76T1bm", "confirmationsCount": 2, "serializedMessage": "string", "errorMessage": "string", "txnTimestamp": "2025-10-21T16:17:45.035372Z" }

Request

Responses