# refresh_account

> Page: https://docs.flung.dev/reference/mcp/refresh-account. Index of every page: https://docs.flung.dev/llms.txt

Refresh an account now. Renews the access token now and reports refreshed, not_needed, reconnect_required or failed. Flung renews tokens hourly by itself, so use this only to check that an account still works; reconnect_required means call reconnect_account.

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Renews the access token now and reports refreshed, not_needed, reconnect_required or failed. Flung renews tokens hourly by itself, so use this only to check that an account still works; reconnect_required means call reconnect_account. |
| Does it change anything? | Changes something; safe to repeat. |
| Which endpoint does it call? | [`POST /v1/accounts/{id}/refresh`](https://docs.flung.dev/reference/api/post-v1-accounts-id-refresh.md) |
| Which server? | `https://mcp.flung.dev/mcp-oauth` (sign in) or `https://mcp.flung.dev/mcp` (API key). |

## Arguments

| Argument | Type | Required | Description |
|---|---|---|---|
| `accountId` | `string` | yes | An account id (acct_...) from list_accounts. at least 1 character; at most 64 characters; pattern `^acct_[a-z2-7]+$`. |

## Example call

```json
{
  "name": "refresh_account",
  "arguments": {
    "accountId": "acct_aaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

## Things a person might say

- "Check my X account still works."

## Annotations

| Hint | Value |
|---|---|
| `readOnlyHint` | false |
| `destructiveHint` | false |
| `idempotentHint` | true |
| `openWorldHint` | true |

## See also

| Doc | Why |
|---|---|
| [MCP tools](https://docs.flung.dev/reference/mcp.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`POST /v1/accounts/{id}/refresh`](https://docs.flung.dev/reference/api/post-v1-accounts-id-refresh.md) | The same operation over HTTP |
