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

# Get async run status

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

## Request

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

Retrieve streaming status or error information for an asynchronous agent run. Once the returned status is `done`, call `/api/agents/:agentId/run-async/:runId/result` for the completed payload.

## 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
  - `status` 'queued' | 'running' | 'waiting' | 'done' | 'error' | 'interrupted', required: Chat execution status
  - `statusMessage` string: Additional status context, typically error messages

## 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)