---
title: "List Agent Schedules"
method: GET
path: "/agents/{agent_id}/schedules"
tags: ["Schedules"]
---

# List Agent Schedules

`GET /agents/{agent_id}/schedules`

List all schedules for an agent.

## Path parameters

- `agent_id` string, required

## Query parameters

- `page_size` integer

## Response `200`

Successful Response

- ScheduleListResponse — Response model for listing schedules
  - `schedules` ScheduleListItem[], required — List of schedules
    - `agent_id` string, required — ID of the agent this schedule belongs to
    - `name` string, required — Human-readable name for the schedule
    - `next_action_time` string, date-time, nullable — Next scheduled execution time
    - `schedule_id` string, required — Unique identifier for the schedule
    - `state` 'ACTIVE' | 'PAUSED', required — Schedule state enum
    - `workflow_name` string, nullable — Name of the scheduled workflow
  - `total` integer, required — Total number of schedules

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)