---
title: "Update account status"
description: "Change an account's status. Set `frozen` to suspend an account, `active` to reactivate it, or `deleted` to close it."
protocol: rest
method: PATCH
endpoint: "/v1/accounts/{account_id}/status"
baseUrl: "https://api.gravv.xyz"
group: "Accounts"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Update account status

<Endpoint method="PATCH" path="/v1/accounts/{account_id}/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.

## Path Parameters

<ParamField name="account_id" path="account_id" type="string" required>
</ParamField>

## Request Body

<ParamField name="status" body="status" type="string" required>
  The new account status.

  Possible values: `active`, `frozen`, `deleted`
</ParamField>

### Request Examples

<RequestExample>

```json title="Freeze"
{
  "status": "frozen"
}
```

```json title="Reactivate"
{
  "status": "active"
}
```

</RequestExample>

## Responses

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

### 200 response

<ResponseField name="data" type="object" required>

  <Expandable title="properties">
    <ResponseField name="id" type="string">
    </ResponseField>

    <ResponseField name="label" type="string">
    </ResponseField>

    <ResponseField name="date_created" type="string">
    </ResponseField>

    <ResponseField name="wallet_address" type="string">
    </ResponseField>

    <ResponseField name="blockchain_network" type="string">
    </ResponseField>

    <ResponseField name="type" type="string">
      Account kind.
    </ResponseField>

    <ResponseField name="customer_id" type="string">
    </ResponseField>

    <ResponseField name="capabilities" type="string[]">
    </ResponseField>

    <ResponseField name="currency" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_id" type="string">
    </ResponseField>

    <ResponseField name="tenant_name" type="string">
    </ResponseField>

    <ResponseField name="tenant_id" type="string">
    </ResponseField>

    <ResponseField name="tier" type="string">
    </ResponseField>

    <ResponseField name="status" type="string">

      Possible values: `active`, `frozen`, `deleted`, `pending`
    </ResponseField>

    <ResponseField name="category" type="string">
    </ResponseField>

    <ResponseField name="balance" type="string">
    </ResponseField>

    <ResponseField name="is_tokenized" type="boolean">
    </ResponseField>

    <ResponseField name="inflow_behavior" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_name" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_address" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_beneficiary_address" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_beneficiary_name" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_account_number" type="string">
    </ResponseField>

    <ResponseField name="virtual_account_bank_routing_number" type="string">
    </ResponseField>

    <ResponseField name="assets" type="object[]">

      <Expandable title="properties">
        <ResponseField name="balance" type="string">
        </ResponseField>

        <ResponseField name="decimals" type="integer">
        </ResponseField>

        <ResponseField name="symbol" type="string">
        </ResponseField>

      </Expandable>
    </ResponseField>

    <ResponseField name="metadata" type="object">
    </ResponseField>

  </Expandable>
</ResponseField>

<ResponseField name="error" type="null" required>
</ResponseField>

### 400 response

<ResponseField name="data" type="null" required>
</ResponseField>

<ResponseField name="error" type="string" required>
  Human-readable error message.
</ResponseField>

## Authorization

- **ApiKeyAuth**