# Recheck Email Account

> Check an account's mailbox again now, after you fixed a connection problem.

> Documentation index: https://www.foxreach.io/docs/llms.txt lists every page of these docs. Each page is also served as Markdown: add `.md` to its URL.

`POST` https://api.foxreach.io/api/v1/email-accounts/{account_id}/recheck

Requires an API key with the `write` scope.

FoxReach retries an account with a connection error on its own, waiting longer after each failure. Call this after you fix the problem (for example, you turned IMAP back on or the mail host is back up) to check the mailbox now instead of waiting. The check runs in the background with the password or Google sign-in already saved on the account. When the mailbox answers, the error clears and `connectionStatus` goes back to `connected`; read the account with [Get Email Account](https://www.foxreach.io/docs/api-reference/email-accounts/get-account) a few seconds later to see the outcome. If the password itself changed, use [Reconnect Account](https://www.foxreach.io/docs/api-reference/email-accounts/reconnect-account) instead. One recheck per account per minute.

## Path Parameters

- `account_id` string path required: The email account id.

## Response

Returns `202 Accepted`.

- `data` object

  - `queued` boolean: Always `true`: the check is queued.
  - `accountId` string: The account being checked.

**Request example**

```bash cURL
curl -X POST "https://api.foxreach.io/api/v1/email-accounts/acc_abc123/recheck" \
  -H "X-API-Key: otr_your_key"
```

```python Python SDK (beta)
from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
client.email_accounts.recheck("acc_abc123")
```

```typescript TypeScript SDK (beta)
import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
await client.emailAccounts.recheck("acc_abc123");
```

**Response example**

```json
{
  "data": { "queued": true, "accountId": "acc_abc123" }
}
```

## Errors

| Status | Description |
|--------|-------------|
| `401` | Missing, invalid, revoked or expired API key |
| `403` | API key does not have the required scope: `write` |
| `404` | `Email account not found`: the account does not exist in this workspace |
| `429` | A recheck for this account started less than a minute ago. `Retry-After` gives the seconds to wait |

## Rate Limit

- **100 requests per minute, shared by every `expensive` call in your workspace.** Fixed 60-second window.
- Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix epoch seconds) and `X-RateLimit-Bucket` (`expensive`).
- A `429` response includes a `Retry-After` header (seconds until the bucket resets).

For client-side patterns, see [Rate Limiting](https://www.foxreach.io/docs/rate-limiting).
