---
title: "Get async run status (deprecated)"
method: GET
path: "/api/agents/{agentId}/run-async/{runId}"
tags: ["Agents"]
deprecated: true
---

# Get async run status (deprecated)

`GET /api/agents/{agentId}/run-async/{runId}`

## Request

- Base URL: `https://app.cotool.ai`
- URL: `https://app.cotool.ai/api/agents/{agentId}/run-async/{runId}`
- Auth: HTTP bearer

> **Deprecated.**

> ⚠️ **Deprecated**
> Superseded by the run status endpoint, which returns the run status (queued, running, waiting, done, error, interrupted) and any status message instead of a bare isStreaming flag. Poll GET /api/agents/{agentId}/run-async/{runId}/status until status is done, error, or interrupted, then fetch GET /api/agents/{agentId}/run-async/{runId}/result. No sunset is scheduled.
> **Use instead:** `/api/agents/:agentId/run-async/:runId/status`

Retrieve streaming status or error information for an asynchronous agent run.

## Path parameters

- `agentId` string, uuid, required: Unique identifier of the agent
- `runId` string, uuid, required: Unique identifier of the asynchronous run to check status for

## Response `200`

Successful response

- object: Status information for asynchronous agent run
  - `isStreaming` boolean, required: Whether the run is actively streaming (in-progress)
  - `error` string: Error message if the run failed

## Other responses

- `400`: Bad request — input validation failed or the request was malformed
- `401`: Unauthorized — missing or invalid API key / session
- `403`: Forbidden — the authenticated user lacks the required permissions
- `500`: Internal server error

---

[API](https://skmtc.dev/cotool/apis/cotool-api.md) - [All operations](https://skmtc.dev/cotool/apis/cotool-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cotool/apis/cotool-api/revisions/f5abe0add203?raw)