---
title: "List AI Agent Tasks"
method: GET
path: "/v1/ai/agents/tasks"
tags: ["AI Agent Tasks"]
---

# List AI Agent Tasks

`GET /v1/ai/agents/tasks`

Returns a list of AI agent tasks for the account, optionally filtered by project, branch, status, or creation time.

## Query parameters

- `projectId` string
- `branchId` string
- `status` 'RUNNING' | 'STOPPED' | 'STOPPING' | 'ERRORED'
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `page` integer
- `size` integer

## Response `200`

Agent tasks listed successfully

- GetTasksResponse
  - `page` integer — The current page number (0-indexed)
  - `size` integer — The number of tasks per page
  - `tasks` TaskSummary[] — The list of agent tasks for the account
    - `agentName` string — The name of the agent handling the task
    - `branchId` string — The branch the task is associated with
    - `createdAt` string, date-time — The date and time the task was created
    - `description` string — A short description of what the agent was asked to do
    - `mode` 'PLAN' | 'ACT' — The execution mode the task is running in
    - `modifiedAt` string, date-time — The date and time the task was last modified
    - `projectId` string — The ID of the project the task is associated with
    - `status` 'RUNNING' | 'STOPPED' | 'STOPPING' | 'ERRORED' — The current status of the task
    - `taskId` string, uuid — The unique identifier of the task
  - `total` integer — The total number of matching tasks

## Other responses

- `400` — Invalid filter parameters
- `401` — Missing or invalid authentication token
- `403` — Insufficient permissions to list agent tasks
- `404` — Resource not found
- `502` — Upstream service error
- `504` — Upstream service timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)