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

# Get async run result

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

## Request

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

Retrieve the completed result of an asynchronous agent run. Use the status endpoint first and call this endpoint once the run status is `done`.

## 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: Completed result of an asynchronous agent execution
  - `finalAssistantMessage` string, required: The final text response from the assistant
  - `allToolCallsMade` object[], required: All tool calls made during the agent run
    - `type` 'tool-call', required
    - `toolCallId` string, required
    - `toolName` string, required
    - `args` unknown
  - `allToolResultsReceived` object[], required: All tool results received during the agent run
    - `type` 'tool-result', required
    - `toolCallId` string, required
    - `toolName` string, required
    - `result` unknown
    - `isError` boolean
  - `messages` union[], required: Complete message history from the agent run
    - union
      - object
        - `role` 'system', required
        - `content` string, required
      - object
        - `role` 'user', required
        - `content` union, required
          - string
          - union[]
            - union
              - …
      - object
        - `role` 'assistant', required
        - `content` union, required
          - string
          - union[]
            - union
              - …
      - object
        - `role` 'tool', required
        - `content` object[], required
          - `type` 'tool-result', required
          - `toolCallId` string, required
          - `toolName` string, required
          - `result` unknown
          - `isError` boolean
  - `structuredOutputResult` union: A JSON value (string, number, boolean, null, array, or object)
    - string
    - number
    - boolean
    - JsonValue[]
    - object

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