WAwarp
Agents

List available agent skills

Changed on

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

get/agent

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Query parameters

repostring

Optional repository specification to list agents from (format: "owner/repo"). If not provided, lists agents from all accessible environments.

refreshboolean

When true, clears the agent list cache before fetching. Use this to force a refresh of the available agents.

sort_by'name' | 'last_run'

Sort order for the returned agents.

  • "name": Sort alphabetically by name (default)
  • "last_run": Sort by most recently used
include_malformed_skillsboolean

When true, includes skills whose SKILL.md file exists but is malformed. These variants will have a non-empty error field describing the parse failure. Defaults to false.

Headers

X-Warp-Team-Uidstring

UID of the team to use as the request's active team. Ignored for service-account callers, which always act as their bound team.

Response

List of available agents

Changes