Skip to navigation

Reset Auto Liq Status

View as Markdown

Reset an account’s auto-liquidation status on Demo.

Available to: Organization administrators (accounts in their organization)

Environments: Demo

Rate Limit: No endpoint-specific limit

Reset an account’s risk status and recalculate it. Pass the accountId. The response returns accountRiskStatus as it stands right after the reset, before maxNetLiq and minNetLiq are recalculated.

Resetting clears every risk-status field except maxNetLiq and its timestamp. That includes any admin action on the account (such as a lock), auto-liquidation counters and timestamps, the approval deadline, the stepped-drawdown cooldown state, and the account’s notes. Right after the reset, minNetLiq is set to the account’s current net liquidation value plus its evaluationSize (if it has one), and maxNetLiq to the higher of its existing value and that figure. Both timestamps update.

Common Failure Scenarios

  • The request is sent to Live. This returns HTTP 401 with "Access is denied", not HTTP 501.
  • The caller isn’t an organization administrator. This returns HTTP 401 with "mustBeOrganizationAdmin".
  • No account matches accountId, or the caller can’t access it. Both return HTTP 404 with an empty body.
  • The caller’s user type, or the API key’s permissions, don’t include full access to the Risks resource. This returns HTTP 401 with "Access is denied".
  • accountId isn’t greater than 0. This returns HTTP 400.

Error Messages

MessageResponseTrigger
"Account Id should be greater than 0"400accountId isn’t greater than 0.
"Access is denied"401The caller’s user type, or the API key’s permissions, don’t include full access to the Risks resource.
"Access is denied"401Called on the Live environment.
"mustBeOrganizationAdmin"401Called on Demo by a caller who isn’t an organization administrator.
(no message text)404No account matches accountId, or the caller can’t see it.

Related Endpoints

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
accountIdlongRequired

Response

AccountRiskStatusResponse
errorTextstringOptional<=8192 characters

Non-empty if the request failed

accountRiskStatusobjectOptional