> ## Documentation Index > Fetch the complete documentation index at: https://docs.ascii.dev/llms.txt > Use this file to discover all available pages before exploring further. # List box conversations > Every conversation on the Box, most recently prompted first, with what you need to pick one: how many prompts it holds, whether a turn is running in it right now, the last harness and model it ran on, a preview of its last prompt, and `current`, the one a `POST /prompt` without `new` or `conversationId` would continue. Pass an `id` back as `conversationId` on `POST /prompt` to resume that thread, or as `conversation` on `POST /steer`, `POST /interrupt` and `GET /events` to scope those. See [Integrated agents](/box/integrated-agents). ## OpenAPI ````yaml openapi/box-v1.yaml GET /boxes/{boxId}/conversations openapi: 3.1.0 info: title: Box Public API v1 version: 1.0.0 description: > Public JSON API for creating, operating, prompting, observing, and exposing Box sandboxes from backend services, CI jobs, hosted workers, and Box automation products. The v1 reference intentionally documents the developer integration surface only. Dashboard billing actions are not part of v1. servers: - url: https://ascii.dev/api/box/v1 security: - BoxBearerAuth: [] tags: - name: Box description: >- Unified Box account, setup, lifecycle, prompting, event history, desktop access, and SSH operations. paths: /boxes/{boxId}/conversations: get: tags: - Box summary: List box conversations description: >- Every conversation on the Box, most recently prompted first, with what you need to pick one: how many prompts it holds, whether a turn is running in it right now, the last harness and model it ran on, a preview of its last prompt, and `current`, the one a `POST /prompt` without `new` or `conversationId` would continue. Pass an `id` back as `conversationId` on `POST /prompt` to resume that thread, or as `conversation` on `POST /steer`, `POST /interrupt` and `GET /events` to scope those. See [Integrated agents](/box/integrated-agents). operationId: conversations parameters: - $ref: '#/components/parameters/BoxId' responses: '200': description: >- Conversations on the Box. A Box that was never prompted returns an empty list. content: application/json: schema: $ref: '#/components/schemas/ConversationsResponse' examples: twoConversations: value: ok: true type: conversation.list id: bx_23456789 conversations: - id: 8f1c2b7a-3d4e-4f5a-9b0c-1d2e3f4a5b6c createdAt: '2026-09-08T10:05:00.000Z' lastPromptAt: '2026-09-08T10:05:00.000Z' prompts: 1 running: true lastHarness: pi lastModel: claude-sonnet-5 lastPromptPreview: Investigate the flaky CI job current: true - id: 2c0d9e4b-7a1f-4c3e-8b5d-6e7f8a9b0c1d createdAt: '2026-09-08T09:40:00.000Z' lastPromptAt: '2026-09-08T10:03:00.000Z' prompts: 2 running: false lastHarness: claude lastModel: claude-opus-4-8 lastPromptPreview: Now add tests current: false '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '404': $ref: '#/components/responses/NotFound' components: parameters: BoxId: name: boxId in: path required: true schema: type: string pattern: ^bx_[23456789abcdefghjkmnpqrstuvwxyz]{8}$ description: Public Box id returned by create/list/get box calls. schemas: ConversationsResponse: allOf: - $ref: '#/components/schemas/SuccessBase' - type: object required: - id - conversations properties: type: type: string const: conversation.list id: type: string description: Box id. conversations: type: array items: $ref: '#/components/schemas/Conversation' SuccessBase: type: object required: - ok - type properties: ok: type: boolean examples: - true type: type: string description: Stable success envelope discriminator added by v1. Conversation: type: object required: - id - createdAt - lastPromptAt - prompts - running - lastHarness - lastModel - lastPromptPreview - current properties: id: type: string description: >- Conversation id. Pass it as `conversationId` on `POST /prompt` to continue this thread. createdAt: type: - string - 'null' format: date-time description: When the first prompt of this conversation was queued. lastPromptAt: type: - string - 'null' format: date-time description: >- When its most recent prompt was queued. The list is sorted by this, newest first. prompts: type: integer description: Number of prompts sent to this conversation. running: type: boolean description: '`true` while a turn is queued or running in this conversation.' lastHarness: type: - string - 'null' description: >- Harness the most recent prompt ran on (`claude`, `codex`, `pi`, `opencode`, `prime-agent`, `kimi`). lastModel: type: - string - 'null' description: >- Model id of the most recent prompt that chose one, or `null` when every prompt used the harness default. lastPromptPreview: type: - string - 'null' description: The first 80 characters of the most recent prompt. current: type: boolean description: >- `true` on the conversation a `POST /prompt` without `new` or `conversationId` would continue: the Box's most recently prompted one. Exactly one conversation is current unless the list is empty. ErrorEnvelope: type: object required: - ok - type - status - code - message - error - requestId properties: ok: type: boolean examples: - false type: type: string examples: - box.error status: type: integer examples: - 409 code: type: string examples: - provider_not_configured message: type: string examples: - Prompting is locked until Codex is configured on the Agents page. requestId: type: string examples: - req_01HX... error: type: object required: - code - message - status properties: code: type: string message: type: string status: type: integer details: type: object additionalProperties: true responses: Unauthorized: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: unauthorized: value: ok: false type: box.error status: 401 code: unauthorized message: Unauthorized error: code: unauthorized message: Unauthorized status: 401 requestId: req_01HX... PaymentRequired: description: >- Account cannot currently create or operate Boxes. The error body may include a dashboard billing URL, but billing actions are not part of the v1 API. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: BoxBearerAuth: type: http scheme: bearer bearerFormat: box_api_key description: >- Box bearer token in the form `box_...`. Service API keys authenticate Box operations. ````