---
title: "List agents"
method: GET
path: "/agent"
---

# List agents

`GET /agent`

Get a list of all available AI agents in the Arctic system.

## Query parameters

- `directory` string

## Response `200`

List of agents

- Agent[]
  - `name` string, required
  - `description` string
  - `mode` 'subagent' | 'primary' | 'all', required
  - `builtIn` boolean, required
  - `topP` number
  - `temperature` number
  - `color` string
  - `permission` object, required
    - `edit` 'ask' | 'allow' | 'deny', required
    - `bash` object, required
    - `webfetch` 'ask' | 'allow' | 'deny'
    - `doom_loop` 'ask' | 'allow' | 'deny'
    - `external_directory` 'ask' | 'allow' | 'deny'
  - `model` object
    - `modelID` string, required
    - `providerID` string, required
  - `prompt` string
  - `tools` object, required
  - `options` object, required
  - `maxSteps` integer

---

[API](https://skmtc.net/arctic-cli/apis/arctic.md) · [All operations](https://skmtc.net/arctic-cli/apis/arctic/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arctic-cli/arctic/versions/d64a58bed245/schema)