---
title: "Get Run Status"
method: GET
path: "/auto-agent/run/{run_id}"
tags: ["auto-agent"]
---

# Get Run Status

`GET /auto-agent/run/{run_id}`

Get the status and results of an Auto Agent run.

Poll this endpoint to check if the run is still running or has completed.
When the run is active and new logs exist, schedules a background task to
generate an AI progress summary.

Args:
    run_id: UUID of the run to check.
    auth: Authenticated user (ownership is enforced).

Returns:
    Current run status and results if complete.

Raises:
    HTTPException: 404 if run not found or not owned by user.

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- AutoAgentRunStatus — Current status and results of an Auto Agent run. Args: run_id: UUID of the run. status: Current status (running | complete | failed). message: The task description the user provided. project_id: Project grouping all datasets and models from this run. deliverables_json: Parsed deliverables.json when complete. curation_report: Contents of data-curation.md when complete. final_report: Contents of final_report.md when complete. error_message: Error description when failed. tool_calls_made: Number of tool calls the agent executed. created_at: ISO timestamp when the run was created. completed_at: ISO timestamp when the run completed, or None. current_phase: High-level progress phase for the frontend stepper.
  - `run_id` string, required — Run UUID
  - `status` string, required — running | complete | failed | stopped
  - `message` string — User task description
  - `project_id` string, nullable — Project ID grouping datasets and models from this run
  - `deliverables_json` object, nullable — Parsed deliverables.json (available when complete)
  - `curation_report` string, nullable — data-curation.md contents (available when complete)
  - `final_report` string, nullable — final_report.md contents (available when complete)
  - `error_message` string, nullable — Error description (available when failed)
  - `tool_calls_made` integer — Number of tool calls executed
  - `created_at` string, required — ISO timestamp of run creation
  - `completed_at` string, nullable — ISO timestamp of completion
  - `current_phase` string, nullable — High-level progress phase: analyzing | researching | preparing_data | training | evaluating | finalizing
  - `progress_updates` object[], nullable — Accumulating AI-generated progress summaries, each with summary and timestamp

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)