---
title: "Get the Cloud thread bound to this conversation"
method: GET
path: "/v1/conversations/{id}/codex-cloud"
tags: ["Codex Cloud"]
---

# Get the Cloud thread bound to this conversation

`GET /v1/conversations/{id}/codex-cloud`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/conversations/{id}/codex-cloud`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Default Response

- CodexCloudTask
  - `conversation_id` string, required
  - `workspace_id` string, uuid, required: UUIDv7, lowercase canonical form.
  - `state` 'preparing' | 'active' | 'attention' | 'canceling' | 'canceled', required
  - `thread_id` string, nullable, required
  - `desktop_url` string, nullable, required
  - `web_url` string, nullable
  - `account` object, nullable: The Codex account the thread runs under (an account of GET /v1/agent-accounts, also after it was removed); null when not recorded (a thread started before 2026-10-15).
    - `id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `label` string, required
    - `email` string, nullable, required
    - `chatgpt_account_id` string, nullable, required: The ChatGPT account (workspace) id, as tokens.account_id in ~/.codex/auth.json; null when its login did not say.
  - `previous_thread_ids` string[]
  - `previous_threads` object[]: The conversation’s earlier Cloud threads, oldest first, each with the Codex account it ran under: a switch of the active Codex account continues the conversation in a new thread, and the earlier chat stays in its own account.
    - `thread_id` string, required
    - `web_url` string, required
    - `desktop_url` string, required
    - `account` object, nullable, required: The Codex account the thread runs under (an account of GET /v1/agent-accounts, also after it was removed); null when not recorded (a thread started before 2026-10-15).
      - `id` string, uuid, required: UUIDv7, lowercase canonical form.
      - `label` string, required
      - `email` string, nullable, required
      - `chatgpt_account_id` string, nullable, required: The ChatGPT account (workspace) id, as tokens.account_id in ~/.codex/auth.json; null when its login did not say.
  - `next_attempt_at` string, date-time, nullable: Next automatic admission retry; null with attention means automatic admission stopped. Follow last_error and explicitly send a message or admit again after fixing its cause. Absent on older APIs.
  - `last_error` string, nullable, required

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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