---
title: "List available agents"
method: GET
path: "/agent"
tags: ["agent"]
---

# List available agents

`GET /agent`

Retrieve a list of available agents (skills) that can be used to run tasks.
Agents are discovered from environments or a specific repository.

## Query parameters

- `repo` string
- `refresh` boolean
- `sort_by` 'name' | 'last_run'
- `include_malformed_skills` boolean

## Response `200`

List of available agents

- ListAgentsResponse
  - `agents` AgentListItem[], required — List of available agents
    - `name` string, required — Human-readable name of the agent
    - `variants` AgentListVariant[], required — Available variants of this agent
      - `id` string, required — Stable identifier for this skill variant. Format: "{owner}/{repo}:{skill_path}" Example: "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"
      - `description` string, required — Description of the agent variant
      - `base_prompt` string, required — Base prompt/instructions for the agent
      - `source` AgentListSource, required
        - `owner` string, required — GitHub repository owner
        - `name` string, required — GitHub repository name
        - `skill_path` string, required — Path to the skill definition file within the repository
        - `worker_host` string — Self-hosted worker host that reported this skill. Present only for skills discovered from self-hosted workers (as opposed to skills from GitHub repos linked to environments).
      - `environments` AgentListEnvironment[], required — Environments where this agent variant is available
        - `uid` string, required — Unique identifier for the environment
        - `name` string, required — Human-readable name of the environment
      - `last_run_timestamp` string, date-time, nullable — Timestamp of the last time this skill was run (RFC3339)
      - `error` string — Non-empty when the skill's SKILL.md file exists but is malformed. Contains a description of the parse failure. Only present when include_malformed_skills=true is passed to the list agents endpoint.

## Other responses

- `400` — Invalid repository specification

---

[API](https://skmtc.net/warp/apis/oz-agent-api.md) · [All operations](https://skmtc.net/warp/apis/oz-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/warp/oz-agent-api/revisions/97be876c33e3/schema)