---
title: "List Expert Runs"
method: GET
path: "/api/experts/{expert_id}/runs"
tags: ["v2", "experts", "experts", "private"]
---

# List Expert Runs

`GET /api/experts/{expert_id}/runs`

Recent executions attributed to this expert, with a classified output
type for the Work surface's typed viewer.

## Path parameters

- `expert_id` string, required

## Response `200`

Successful Response

- ExpertRun[]
  - `execution_id` string, required
  - `graph_id` string, required
  - `agent_name` string, required
  - `library_agent_id` string, nullable, required
  - `status` 'incomplete' | 'queued' | 'running' | 'completed' | 'terminated' | 'failed' | 'review', required
  - `output_type` 'table' | 'doc' | 'image' | 'unknown', required
  - `output_key` string, nullable, required
  - `needs_review` boolean, required
  - `started_at` string, date-time, nullable, required
  - `ended_at` string, date-time, nullable, required
  - `link` string, nullable, required

## Other responses

- `401` — Authentication required
- `404` — Expert not found
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/2f82328f5184/schema)