---
title: "Get run diagnostics"
method: GET
path: "/agent/runs/{runId}/diagnostics"
tags: ["Agents"]
---

# Get run diagnostics

`GET /agent/runs/{runId}/diagnostics`

## Request

- Base URL: `https://app.warp.dev/api/v1`
- URL: `https://app.warp.dev/api/v1/agent/runs/{runId}/diagnostics`
- Auth: HTTP bearer

Retrieve diagnostics recorded for an agent run.

## Path parameters

- `runId` string, required

## Response `200`

Run diagnostics

- GetRunDiagnosticsResponse: Response body for listing diagnostics recorded for a run.
  - `diagnostics` RunDiagnostic[], required
    - `message` string, required
    - `code` string, required
    - `data` object
    - `timestamp` string, date-time
    - `created_at` string, date-time: When the diagnostic was recorded.

## Other responses

- `400`: Missing run ID
- `401`: Authentication required
- `403`: No permission to access run
- `500`: Internal server error

## Changes

- **2026-11-04** `4b5d145669be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/runs/:runId/diagnostics/get.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/warp/apis/oz-agent-api/revisions/4b5d145669be?raw)