---
title: "Inspect an operator conversation"
description: "Returns the conversation and its unfinished turns. Settled turns are in the conversation's history."
canonical: "https://www.cool.computer/docs/api-reference/operator/inspect-an-operator-conversation"
---
# Inspect an operator conversation

> Returns the conversation and its unfinished turns. Settled turns are in the conversation's history.

```http
GET https://api.cool.computer/api/operator/conversations/{id}
```

Returns the conversation and its unfinished turns. Settled turns are in the conversation's history.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

## Parameters

- `id` (path, string, at least 1 characters, required): Operator conversation identifier.

## Responses

- `200`: The conversation.
  - `application/json` (object)
    - `id` (string, required)
    - `title` (string, required)
    - `computer_ids` (array of string, required): Computers referenced by the chat or used by its tool calls.
    - `pi_version` (string, required)
    - `status` ("running" or "completed")
    - `created_at` (string, date-time, required)
    - `updated_at` (string, date-time, required)
    - `turns` (array of object, required): Only unfinished turns (queued, claimed, or running), so it is empty once every turn settles. Settled turns and their replies are in the conversation's history.
      - `id` (string, required)
      - `conversation_id` (string)
      - `source` ("browser" or "api" or "email" or "mcp" or "messaging" or "comments" or "system", required): Who queued the turn. messaging is a direct message from a connected Telegram or Slack account. comments is a site owner asking the agent to handle comments on the site's page. system is Cool Computers itself: a turn that reports a recorded operation result, or one that wakes the chat because a background process it started ended or, as a monitor, printed new lines.
      - `message` (string, required)
      - `state` ("queued" or "claimed" or "running" or "succeeded" or "failed" or "cancelled" or "interrupted", required)
      - `attempt` (integer, at least 0, required)
      - `cancellation_requested` (boolean, required)
      - `presented` (boolean, required): The turn's message has been recorded in the conversation's events.
      - `attachments` (array of object, required)
        - `id` (string, required)
        - `filename` (string, required)
        - `media_type` (string, required): image/png, image/jpeg, image/gif, image/webp, video/mp4, video/quicktime, video/webm, or a text type.
        - `size_bytes` (integer, at least 0, required)
        - `width` (integer, at least 1): An image's stored width, the width the model sees.
        - `height` (integer, at least 1): An image's stored height, the height the model sees.
      - `provider` (string, required)
      - `model` (string, required)
      - `usage` (any): Token usage as the provider reported it.
      - `error` (string)
      - `created_at` (string, date-time, required)
      - `completed_at` (string, date-time)
- `401`: Unauthorized.
- `404`: Not Found.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: Internal Server Error.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl "https://api.cool.computer/api/operator/conversations/$PARAM_ID" \
  -H "authorization: Bearer $TOKEN"
```
