---
title: "One conversation with its turns"
method: GET
path: "/assistant/conversations/{conversationId}"
tags: ["Assistant"]
---

# One conversation with its turns

`GET /assistant/conversations/{conversationId}`

## Request

- Base URL: `https://hostingsurge.com/api/v1`
- URL: `https://hostingsurge.com/api/v1/assistant/conversations/{conversationId}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-hs_session`

## Path parameters

- `conversationId` string, uuid, required

## Response `200`

The conversation

- object
  - `conversation` object, required
    - `id` string, uuid, required
    - `organizationId` string, uuid, required
    - `title` string, required
    - `createdAt` string, required: ISO-8601 timestamp
    - `updatedAt` string, required: ISO-8601 timestamp
    - `lastTurnAt` string, nullable, required: ISO-8601 timestamp
    - `turns` integer, required
  - `turns` object[], required
    - `id` string, uuid, required
    - `conversationId` string, uuid, required
    - `seq` integer, required
    - `prompt` string, required: The question (empty once the conversation was deleted)
    - `answer` string, required: The assistant's answer so far
    - `status` 'running' | 'awaiting_confirmation' | 'done' | 'failed' | 'canceled', required
    - `steps` object[], required
      - `id` string, required
      - `tool` string, required: The MCP tool, e.g. get_runtime_logs
      - `verb` string, required: What it does, e.g. read, delete, deploy
      - `object` string, required: What it acts on, e.g. logs, project, domain
      - `target` string, nullable, required: The project, hostname, database, … it is about, when the tool names one
      - `kind` 'read' | 'change', required
      - `state` 'running' | 'done' | 'failed' | 'waiting' | 'declined', required
      - `error` string, nullable, required: Why it failed, in plain words (already safe to show)
    - `action` object, nullable, required
      - `id` string, required
      - `tool` string, required: The MCP tool, e.g. get_runtime_logs
      - `verb` string, required: What it does, e.g. read, delete, deploy
      - `object` string, required: What it acts on, e.g. logs, project, domain
      - `target` string, nullable, required: The project, hostname, database, … it is about, when the tool names one
      - `details` object[], required: The arguments the change runs with, as sent to the tool (secrets are never part of them)
        - `name` string, required
        - `value` string, required
      - `destructive` boolean, required: Deletes or overwrites something, or stops a running site: cannot be undone
      - `billable` boolean, required: May cost money or count toward the plan's limits
      - `sensitive` boolean, required: Opens access to data or changes who can reach a site (public database access, bucket visibility, edge rules)
      - `expiresAt` string, required: ISO-8601 timestamp
    - `effort` 'low' | 'high' | 'null', nullable, required
    - `model` string, nullable, required
    - `usage` object, required
      - `inputTokens` integer, required
      - `outputTokens` integer, required
      - `cachedInputTokens` integer, required
      - `costMicros` integer, required: Model cost, micro-USD
      - `millicredits` integer, required
      - `credits` number, required
    - `error` object, nullable, required
      - `code` string, required
      - `message` string, required
    - `createdAt` string, required: ISO-8601 timestamp
    - `finishedAt` string, nullable, required: ISO-8601 timestamp

## Other responses

- `400`: Invalid request (code invalid_request; details.reason secret_detected when a question contains a secret)
- `401`: Not signed in (code unauthorized)
- `403`: Not a dashboard session, or the operator switched the assistant off for this team (details.reason assistant_blocked)
- `404`: Not found, or not your conversation (code not_found)
- `501`: No AI model on this server (code not_configured)

---

[API](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api.md) · [All operations](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hostingsurge/apis/hostingsurge-platform-api/revisions/4d08337cdff1?raw)