# Manage accounts

> List, retrieve, reconnect and remove the accounts in your workspace.

Once accounts are [linked](/link-account), these endpoints let you manage them.

## List accounts

```http
GET /v1/accounts
```

```bash
curl https://api.correctinbox.com/v1/accounts \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"
```

```js
const { accounts } = await (
  await fetch("https://api.correctinbox.com/v1/accounts", {
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();
```

```python
accounts = requests.get(
    "https://api.correctinbox.com/v1/accounts",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
).json()["accounts"]
```

**Response**

```json
{
  "accounts": [
    {
      "id": "acc_8f21c0",
      "provider": "LINKEDIN",
      "name": "Aditya Sharma",
      "status": "connected",
      "region": "IN",
      "created_at": "2026-02-01T09:12:00Z",
      "last_checked_at": "2026-02-01T18:40:00Z"
    }
  ]
}
```

## Retrieve one account

```http
GET /v1/accounts/{account_id}
```

```bash
curl https://api.correctinbox.com/v1/accounts/acc_8f21c0 \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"
```

## Reconnect an account

If an account becomes `disconnected`, generate a fresh hosted link to bring it back online. The account keeps its id, history and campaigns.

```http
POST /v1/accounts/{account_id}/reconnect
```

```bash
curl -X POST https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"
```

```js
const { url } = await (
  await fetch("https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect", {
    method: "POST",
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();
```

```python
url = requests.post(
    "https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
).json()["url"]
```

## Remove an account

Disconnects the account and deletes its stored session. Campaign history is retained; running campaigns on it stop.

```http
DELETE /v1/accounts/{account_id}
```

```bash
curl -X DELETE https://api.correctinbox.com/v1/accounts/acc_8f21c0 \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"
```