# List agents

Source: https://immiscible.fly.dev/docs/api/get-v1-cli-agents

`GET /v1/cli/agents`

The agents this person can see, as on the console's Agents page.

## Authentication

CLI token. A token (`imc_...`) the developer CLI gets by signing in through the browser (`immiscible login`, the OAuth device grant), sent as `Authorization: Bearer`. It acts for one person in one workspace: it reads agents and status, and registers an agent with a rule from the same purposes as the console's "Add an agent". It never approves anything or changes an existing rule. Every use re-checks the person's membership and the workspace's sign-in rules; it lasts 90 days and ends from the console's sessions.

## Request

curl:

```bash
curl "https://immiscible.fly.dev/v1/cli/agents" \
  -H "authorization: Bearer $IMMISCIBLE_TOKEN"
```

Node:

```ts
const res = await fetch('https://immiscible.fly.dev/v1/cli/agents', {
  headers: {
    authorization: `Bearer ${process.env.IMMISCIBLE_TOKEN}`,
  },
});
const data = await res.json();
console.log(res.status, data);
```

Python:

```python
import os
import requests

res = requests.get(
    "https://immiscible.fly.dev/v1/cli/agents",
    headers={
        "authorization": f"Bearer {os.environ['IMMISCIBLE_TOKEN']}",
    },
)
print(res.status_code, res.json())
```

## Response

```json
{
  "data": [
    {
      "id": "agt_dd6dc371218b0efb975711eb",
      "name": "Procurement",
      "vendor": "openai",
      "status": "active",
      "tier": "junior",
      "lastActionAt": "2026-09-29T12:44:07.002Z",
      "canManage": true,
      "url": "https://immiscible.fly.dev/app/agents/agt_dd6dc371218b0efb975711eb?w=ws_12832a06f3134d5f"
    }
  ]
}
```