---
title: "List Runs"
method: GET
path: "/threads/{thread_id}/runs"
tags: ["Runs"]
---

# List Runs

`GET /threads/{thread_id}/runs`

List runs for a thread.

## Path parameters

- `thread_id` string, uuid, required — The ID of the thread.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Success

- Run[]
  - `run_id` string, uuid, required — The ID of the run.
  - `thread_id` string, uuid, required — The ID of the thread.
  - `assistant_id` string, uuid, required — The assistant that was used for this run.
  - `created_at` string, date-time, required — The time the run was created.
  - `updated_at` string, date-time, required — The last time the run was updated.
  - `status` 'pending' | 'error' | 'success' | 'timeout' | 'interrupted', required — The status of the run. One of 'pending', 'error', 'success', 'timeout', 'interrupted'.
  - `metadata` object, required — The run metadata.
  - `kwargs` object, required
  - `multitask_strategy` 'reject' | 'rollback' | 'interrupt' | 'enqueue', required — Strategy to handle concurrent runs on the same thread.

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/xpert-ai/apis/agent-protocol.md) · [All operations](https://skmtc.net/xpert-ai/apis/agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpert-ai/agent-protocol/versions/ac9dbe16ea2f/schema)