Update Account

Designing

Development

https://vf-solana-api.dev.alphaledger.com

PATCH

/api/v1/accounts

Creates Solana Transaction:No

OperationId:updateAccount

Update certain attributes on the specified account. This functions as a patch. Only fields specified in the request body will be updated. The rest of the fields already present on the account remain unchanged.

The VULCAN_FORGE_UPDATE_DEBIT_API_KEYS role is required to allow the API Key to change the solDebitApiKeys or tokenDebitApiKeys fields.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Too Many Requests

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://vf-solana-api.dev.alphaledger.com/api/v1/accounts?solanaClusterId=SOLANA_DEVNET' \
--header 'x-request-id: f9860f73-a466-41f2-a083-34eeb1cc3a3c' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "itemData": {
        "accountToUpdate": {
            "onchainId": "GPjDgRPhSuJSya5GbaCWkYCDqcyL6N3ZBge9XMJsDton",
            "offchainId": "1b03ae9a-348c-4c18-8727-20c7c4ae7a0a",
            "offchainReferences": {
                "alId": "ALFNDPF000153778",
                "organizationExternalId": "ALT",
                "accountNumber": "ALT10000233",
                "code": "some-authority",
                "type": "WALLET"
            },
            "isOtherTenantSigner": false,
            "otherTenantOrganizationExternalId": "ALIM",
            "offPlatform": false
        },
        "offchainReferences": {
            "alId": "ALFNDPF000153778",
            "organizationExternalId": "ALT",
            "accountNumber": "ALT10000233",
            "code": "some-authority",
            "type": "WALLET",
            "name": "Some name to provide more context"
        },
        "comments": "string",
        "subscribeToNetworkEvents": true,
        "canPayFees": true,
        "globalFeePayerForOrgs": [
            "string"
        ],
        "solDebitApiKeys": [
            "string"
        ],
        "tokenDebitApiKeys": [
            "string"
        ]
    },
    "tenancyConfig": {
        "overrideOrganizationExternalId": "ALIM"
    }
}'

Response Example

200 - Example 1

{
    "onchainId": "ndA7eTfoWqrczXYUq53gNRRjQgEmufqErXbgXUFFUAA",
    "offchainId": "1a1e904d-0d95-4e66-85e1-88a57774e910"
}

Modified at 2025-12-07 12:33:40

Fetch Accounts

Inactivate Account