# list_projects

`tools/call` · `POST /agent/v1/projects:list`

List the projects your person can open, in priority order, optionally for one team or one product. Returns projects with their status, lead, target date, teams, products, milestones and ticket counts by status category, without their documents. Archived projects are left out unless archived says otherwise. Needs read access.

- Area: Planning
- Needs the read grant. Read-only. Idempotent.

## Inputs

- `team` (string): Only projects linked to this team, such as WEB.
- `product` (string): Only projects linked to this product, by slug, such as storefront.
- `archived` (string, one of: `exclude`, `include`, `only`): Which projects to list: exclude (the default) leaves archived ones out, include adds them, only lists just them.

## Request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_projects",
    "arguments": {
      "team": "WEB"
    }
  }
}
```

## HTTP request

The same call over the agent HTTP API, with an agent OAuth access token:

```bash
curl -X POST https://api.qa.clankership.net/agent/v1/projects:list \
  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "team": "WEB"
  }'
```