{"version":"2.1.307","anchor":"sdk-can-read-cloud-sessions-listgettranscript-with-detai","canonical_anchor":"sdk-can-read-cloud-sessions-listgettranscript-with-detai","heading":"SDK hosts can list and read cloud sessions and their transcripts","tier":"use","area":"Agents","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.307\/e\/sdk-can-read-cloud-sessions-listgettranscript-with-detai","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.307","markdown":"### SDK hosts can list and read cloud sessions and their transcripts\n\nNew SDK requests list cloud sessions and fetch one session or its transcript, with clear refusals when they are not allowed\n\n**What**\n\nThe SDK lets developers run Claude Code from their own program, called the host, which talks to it through control requests. Three new control requests are added:\n\n- `list_cloud_sessions` lists cloud sessions.\n\n- `get_cloud_session` fetches one cloud session.\n\n- `get_cloud_session_transcript` fetches its transcript.\n\nThey are refused, each with its own message, when:\n\n- started inside a Claude Code session\n\n- running in a cloud-hosted session ('is not available in a cloud-hosted session')\n\n- using a provider other than Anthropic's own\n\n- running an evaluation\n\n- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` is set ('Cloud sessions are unavailable while CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set.')\n\n- an organisation policy forbids it\n\n- you are not signed in with a Claude account (Console sign-ins are refused)\n\nThe list of known request names also gains `sdk_list_cloud_sessions`, `sdk_get_cloud_session` and `sdk_get_cloud_session_transcript`, plus names for the Windows sandbox's first start and uninstall.\n\n**Why**\n\nPrograms built on the SDK can now find and read your cloud sessions, and get a clear reason when they are not allowed to.\n\n- Area: Agents\n- Tier: Use it now\n- Useful: 5\/5\n- Signal: 3\/5\n- Scope: individual\n- Heads-up: no"}