> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corafone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update one account

> Update one account by externalId.

## Endpoint

`PATCH /external-api/accounts/:externalId`

## Base path

`/external-api/accounts`

## Headers

* `Authorization: Bearer <org_api_key>`
* `X-Cora-Timestamp: <unix_seconds_or_ms>`
* `X-Cora-Signature: <hmac_sha256_hex>`
* `Content-Type: application/json`

## Request body

Direct or `update` wrapper is supported.

```json theme={null}
{
  "status": "ACTIVE",
  "metadata": {
    "externalApiSyncState": "SYNCED"
  },
  "currentBalance": 450.25
}
```

`status` must be one of the supported granular account statuses listed in [Account](/account-overview). `status_category` is derived by Cora and cannot be updated through this endpoint.

## Success response

```json theme={null}
{
  "success": true,
  "code": "ACCOUNT_UPDATED",
  "message": "Account updated successfully",
  "account": {
    "id": "ACCOUNT_ID",
    "externalId": "FILE_123",
    "organizationId": "ORG_ID",
    "updatedAt": "2026-02-23T12:45:00.000Z"
  }
}
```