Update Account

The Update Account API is designed to modify existing account records within the StoneX system. It validates incoming update requests and atomically persists the changes to the backend database. Additionally, it returns a confirmation response containing the updated account details.

POST

/account-api/v1/update-account

Request

The request body of the Update Account API must contain the following attributes for account updation.

Schema

Attributes	Data Type
accountNumber	String
entityNumber	String
main	Main
Data Block Attributes to be added or updated	Corresponding attribute data type

Example

{
    "accountNumber": "10003382",
    "entityNumber": "301",
    "main": {
        "repCode": "JC01"
    },
    "primaryOwner": {
        "email": "[email protected]"
    }
}

Response

A successful account updation with the Update Account API will return a Request Accepted response without any errors.

Example

In this example, the email address of the Primary Owner has been updated as per the changes passed in the request body above.

{
    "statusCode": 202,
    "message": "Request Accepted",
    "errors": [],
    "traceId": "00-348dbc0708003cecadbd96f47e5f4a75-9fc12eeb59e0b40f-01",
    "hasErrors": false
}

Deleting Values

Deleting values is not currently supported.

Attributes That Cannot Be Updated

• accountNumber
• entityNumber
• registrationType
• accountName
• main.marginIndicator
• main.optionTradingIndicator
• main.optionTradingLevel
• primaryOwner.citizenshipCountry
• primaryOwner.taxIdType
• primaryOwner.taxIdNumber
• associatedParties.citizenshipCountry
• associatedParties.taxIdType
• associatedParties.taxIdNumber
• retirementBenes.id