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

# List agents

`GET /agent`

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

## Query parameters

- `directory` string

## Response `200`

List of agents

- Agent[]
  - `name` string, required
  - `description` string
  - `mode` 'subagent' | 'primary' | 'all', required
  - `native` boolean
  - `hidden` boolean
  - `topP` number
  - `temperature` number
  - `color` string
  - `permission` PermissionRule[], required
    - `permission` string, required
    - `pattern` string, required
    - `action` 'allow' | 'deny' | 'ask', required
  - `model` object
    - `modelID` string, required
    - `providerID` string, required
  - `useSmallModel` boolean
  - `variant` string
  - `prompt` string
  - `skills` string[]
  - `options` object, required
  - `steps` integer
  - `prependRequestContext` boolean

## Changes

- **2026-06-29** `e7837fb0de8f` — 1 info
  - added the optional property `items/useSmallModel` to the response with the `200` status
- **2026-03-17** `437a6ea5aeb3` — 2 info
  - added the optional property `items/prependRequestContext` to the response with the `200` status
  - added the optional property `items/skills` to the response with the `200` status
- **2026-02-01** `a536e7c045da` — 1 info
  - added the optional property `items/variant` to the response with the `200` status
- **2026-01-20** `c7ae6a68e4fb` — 4 warning
  - removed the optional property `items/prependRequestContext` from the response with the `200` status
  - removed the optional property `items/skills` from the response with the `200` status
  - removed the optional property `items/useSmallModel` from the response with the `200` status
  - removed the optional property `items/variant` from the response with the `200` status

[Change history](https://skmtc.dev/cyberstrikeus/apis/cyberstrike/changes/agent/get.md)

---

[API](https://skmtc.dev/cyberstrikeus/apis/cyberstrike.md) · [All operations](https://skmtc.dev/cyberstrikeus/apis/cyberstrike/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cyberstrikeus/cyberstrike/revisions/60718ff578c8/schema)