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

# List agents

`GET /agents`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/agents`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api/docs/agents/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the organization's agents, newest first, one page at a time.

## Query parameters

- `limit` integer: Page size.
- `offset` integer: Where the page starts.
- `search` string: Narrow to agents whose name or id contains this, case-insensitively.
- `kind` '' | 'instructions' | 'code': Narrow to agents whose current revision is instructions or code. Omit for both.
- `created_after` string, date-time: Only agents created at or after this time (RFC 3339).
- `created_before` string, date-time: Only agents created at or before this time (RFC 3339).
- `last_run_after` string, date-time: Only agents last run at or after this time (RFC 3339).
- `last_run_before` string, date-time: Only agents last run at or before this time (RFC 3339).

## Response `200`

OK

- AgentList: One page of the organization's agents, newest first.
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `agents` Agent[], nullable, required: The agents on this page.
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `accessibility_enabled` boolean, required: Runs use accessibility mode, which needs a phone that supports it.
    - `capture_enabled` boolean, required: Runs capture the media they produce on the phone into the file library.
    - `created_at` string, date-time, required: When the agent was created.
    - `current_revision_id` string, uuid: The revision runs of the agent use. Absent until the agent has one.
    - `id` string, uuid, required: The agent's id.
    - `last_run_at` string, date-time: When a run of the agent last started.
    - `max_cost_microdollars` integer, required: Most a run's model steps may cost, in microdollars.
    - `max_steps` integer, required: Most model steps a run may take.
    - `model` string, required: The model an instructions revision's runs call, one of GET /models.
    - `name` string, required: The agent's name, unique within the organization.
    - `output_schema` object: The JSON Schema a run's result must satisfy. Absent takes any result.
    - `pause_timeout_seconds` integer, required: Longest a run waits paused for an answer, in seconds, before it fails with input_timeout. A pause also ends with the session.
    - `recording_enabled` boolean, required: Runs record the screen.
    - `telemetry_enabled` boolean, required: Runs emit telemetry, live and stored.
    - `timeout_seconds` integer, required: Longest a run may take, in seconds, within the one-hour session cap.
    - `updated_at` string, date-time, required: When the agent was last changed.
  - `limit` integer, required: The page size.
  - `offset` integer, required: Where this page starts.
  - `total` integer, required: How many agents match.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-11-01** `80de09d0e643`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api/changes/agents/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api/revisions/80de09d0e643?raw)