---
title: "List an agent's runs, newest first. The authoritative record of what actually fired — filter on trigger == 'cron' for scheduled runs"
method: GET
path: "/api/characters/{char_id}/runs"
tags: ["Runs"]
---

# List an agent's runs, newest first. The authoritative record of what actually fired — filter on trigger == 'cron' for scheduled runs

`GET /api/characters/{char_id}/runs`

## Request

- Base URL: `https://agentsbooks.com`
- URL: `https://agentsbooks.com/api/characters/{char_id}/runs`
- Auth: HTTP bearer

## Path parameters

- `char_id` string, required

## Query parameters

- `limit` integer
- `task_id` string

## Response `200`

OK

---

[API](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api.md) · [All operations](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api/revisions/3be3beabaefb?raw)