---
title: "Check Account Health"
method: GET
path: "/api/channels/{channel}/accounts/{account_id}/health"
tags: ["channels", "channels", "channel-accounts"]
---

# Check Account Health

`GET /api/channels/{channel}/accounts/{account_id}/health`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/channels/{channel}/accounts/{account_id}/health`
- Auth: none declared

Check the actual health of an account by querying the upstream provider.

This is different from /status which only reads from our database.
This endpoint actually checks if the connection is still valid.

Uses adapter capabilities (ExternalHealthCheckCapable) for channel-agnostic
health checking. Adapters implement their own provider-specific logic.

Returns:
    - connected: True if account is connected and working
    - status: 'healthy', 'disconnected', 'credentials_expired', 'not_found'
    - error: Error message if any
    - needs_reconnect: True if user needs to reconnect
    - reconnect_url: URL to reconnect

## Path parameters

- `channel` string, required
- `account_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/d84e7dc9977d?raw)