Gravv DOCS
Docs Agent Get Started
API Reference Update account status

Update account status

Change an account's status. Set frozen to suspend an account, active to reactivate it, or deleted to close it.

Deleting requires the account's wallet balance to be zero. A deleted account can't be changed again, and system-managed accounts can't have their status updated.

PATCH/v1/accounts/{account_id}/status

Path Parameters

Request Body

The new account status.

Possible values: active, frozen, deleted

Request Examples

{
"status": "frozen"
}
{
"status": "active"
}

Responses

Status Description
200 Updated account
400 Request failed. All gateway errors are returned as HTTP 400 with this envelope.

200 response

Account kind.

Possible values: active, frozen, deleted, pending

400 response

Human-readable error message.

Authorization

  • ApiKeyAuth
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.

Ask me anything about the documentation.

ESC