The full session state + a cursor page of the decision trace.
after_index returns turns strictly after that turn_index; limit
(default 50, max 200) caps the page. has_more in the body signals
whether to page again.
Workspace API key as a bearer token: Authorization: Bearer ish_sk_live_.... Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: sessions:run (create a session, submit turns, close), sessions:read (read the session and its decision trace), environments:read and environments:write (manage the workspace's registered environments), tasks:read and tasks:write (manage the workspace's registered tasks), people:read and people:write (the people the workspace can run a session for), and usage:read (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with sessions:run, sessions:read, and tasks:read by default; every other scope must be requested, people:read and usage:read included. An ish user access token also works on the same header for personal scripts.
When the session left open (UTC), stamped on the first terminal transition and never moved. Null while the session is open. This is the timestamp sessions_ended usage buckets on.
Why the session ended, when that is finer than status: credits_exhausted or plan_allowance_exhausted (both end the session as balance_exhausted), or spend_cap_reached. Null for an ordinary ending. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.
Retention window resolved at open: none, 30d, 90d, or indefinite. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.
The person as they were when the session was created, frozen onto the session.
This, not the live person, is what the session was run against: it stays readable and unchanged after the person is edited or deleted, which is what makes an old trace still mean something. id is the person's id at create time.
Additional keys may be present and more may be added over time; treat anything not listed here as unspecified rather than failing on it.
Deliberation budget the session was opened with: low, medium or high. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ish","description":"Documentation for the ish CLI and MCP server. Simulate a visit and read the reactions before you ship.","colors":{"primary":"#C8623F","light":"#D87A55","dark":"#262220"},"logo":{"light":"https://mintcdn.com/ish/4MaJn6-B7_NnPAml/logo/light.svg?fit=max\u0026auto=format\u0026n=4MaJn6-B7_NnPAml\u0026q=85\u0026s=f0edab6b74c19bec95794ee94d7270c2","dark":"https://mintcdn.com/ish/4MaJn6-B7_NnPAml/logo/dark.svg?fit=max\u0026auto=format\u0026n=4MaJn6-B7_NnPAml\u0026q=85\u0026s=da9e886222890dc4edeaf5b77b455102"},"favicon":{"light":"https://mintcdn.com/ish/4MaJn6-B7_NnPAml/favicon.svg?fit=max\u0026auto=format\u0026n=4MaJn6-B7_NnPAml\u0026q=85\u0026s=871b7f0a040fb0e8c3293911bcbfd37d","dark":"https://mintcdn.com/ish/4MaJn6-B7_NnPAml/favicon-dark.svg?fit=max\u0026auto=format\u0026n=4MaJn6-B7_NnPAml\u0026q=85\u0026s=8915499d3e98ef136443c3c38b96e4b9"},"appearance":{"default":"system"},"background":{"color":{"light":"#FDFCFB","dark":"#1A1816"}},"navbar":{"links":[{"href":"https://app.ishlabs.io","label":"Sign in"}],"primary":{"type":"button","label":"Get ish free","href":"https://app.ishlabs.io"}},"footer":{"socials":{"github":"https://github.com/ishlabs"},"links":[{"header":"Product","items":[{"label":"ishlabs.io","href":"https://ishlabs.io"},{"label":"Pricing","href":"https://ishlabs.io/pricing"},{"label":"Sign in","href":"https://app.ishlabs.io"}]}]},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/ishlabs"},{"anchor":"ishlabs.io","icon":"globe","href":"https://ishlabs.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ish","hasAudioNarration":false,"actualSubdomain":"ish","customDomains":["docs.ishlabs.io"],"gitSource":{"type":"github","owner":"ishlabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af0209f0311aab340dbb5c0","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Guides","count":45},{"language":"default","tag":"API","count":42},{"language":"default","tag":"API reference","count":28},{"language":"default","tag":"CLI Reference","count":28},{"language":"default","tag":"Core concepts","count":26},{"language":"default","tag":"MCP Reference","count":21},{"language":"default","tag":"Commands","count":20},{"language":"default","tag":"Overview","count":15},{"language":"default","tag":"Tools","count":13},{"language":"default","tag":"How-to guides","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=\"card-icon\"] svg{background-color:#262220!important}html.dark [data-component-part=\"card-icon\"] svg{background-color:#e8e3de!important}html.dark img[src*=\"/logos/\"]{filter:invert(0.91) brightness(1.03)}#content-area a[href]>div:hover,.ish-card:hover{border-color:#d87a55;transition:border-color 0.15s ease, box-shadow 0.15s ease}"}],"page":{"pagePath":"api/reference/sessions/get-session","slug":"/api/reference/sessions/get-session","pageMetadata":{"title":"Get Session","description":"The full session state + a cursor page of the decision trace.\n\n`after_index` returns turns strictly after that turn_index; `limit`\n(default 50, max 200) caps the page. `has_more` in the body signals\nwhether to page again.","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/sessions/{session_id}","href":"/api/reference/sessions/get-session","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"The full session state + a cursor page of the decision trace.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"after_index\"\n }), \" returns turns strictly after that turn_index; \", _jsx(_components.code, {\n children: \"limit\"\n }), \"\\n(default 50, max 200) caps the page. \", _jsx(_components.code, {\n children: \"has_more\"\n }), \" in the body signals\\nwhether to page again.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Session","description":"The full session state + a cursor page of the decision trace.\n\n`after_index` returns turns strictly after that turn_index; `limit`\n(default 50, max 200) caps the page. `has_more` in the body signals\nwhether to page again.","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/sessions/{session_id}","href":"/api/reference/sessions/get-session","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"The full session state + a cursor page of the decision trace.\n\n`after_index` returns turns strictly after that turn_index; `limit`\n(default 50, max 200) caps the page. `has_more` in the body signals\nwhether to page again.","operationId":"getSession","parameters":["9342c409-95e0-4922-ab20-7e3d61883c28","81a8e365-6060-4a27-9e73-2c2af6043327","d0f1a9bf-9c66-4c3f-a86d-1229d4ea8157"],"responses":{"200":"1b791fbe-9897-46e6-ba78-55ec99d91ba9","401":"e12e73ee-2105-4cb9-946e-c06b4be9f378","403":"70298810-7961-4232-9fa9-7ad3e914afb5","404":"adae3e8f-18d4-4428-921d-5966129d98e2","422":"4a8156d8-1a8f-45fd-858d-2f277b287bc8","429":"de6192e0-c274-4f31-a72a-b8181b367428","500":"f6f78fe1-ab94-402d-96ae-a68e2cc087f6"},"security":["cdb72c81-10f0-4b0e-b865-b8f63d689bdd"],"summary":"Get Session","tags":["sessions"],"method":"get","type":"path","servers":["22c3a961-b6d9-4922-b5aa-d0aac292aa39"],"path":"/api/v1/sessions/{session_id}","baseUrlOptions":["https://api.ishlabs.io"],"title":"Get Session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"9342c409-95e0-4922-ab20-7e3d61883c28":{"in":"path","name":"session_id","required":true,"schema":{"format":"uuid","title":"Session Id","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"81a8e365-6060-4a27-9e73-2c2af6043327":{"in":"query","name":"after_index","required":false,"schema":{"oneOf":[{"type":"integer","title":"After Index","minimum":0,"uniqueKey":"oneOf.0","typeLabel":"integer"},{"type":"null","title":"After Index","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"integer | null"}},"d0f1a9bf-9c66-4c3f-a86d-1229d4ea8157":{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer","isRequired":false,"uniqueKey":"","typeLabel":"integer"}}},"responses":{"1b791fbe-9897-46e6-ba78-55ec99d91ba9":{"content":{"application/json":{"examples":{"default":{"title":"default","value":{"accrued_credits":1,"created_at":"2026-07-28T09:14:02.117000Z","created_by_api_key_id":"5e8f3a21-64c7-4e0b-9a3d-77dd88ee99ff","decision_mode":"intent","ended_at":null,"ended_reason":null,"environment":{"kind":"web","name":"Checkout (staging)"},"environment_id":"3c2a1f80-7e64-4b19-8d55-11aa22bb33cc","environment_revision":4,"environment_version_id":null,"environment_version_label":null,"has_more":false,"id":"7d1e4c09-53af-4d2b-9f60-8c7b6a5e4321","max_turns":20,"observation_retention":"30d","pacing":"pause_on_decide","person_id":"9f1c7b52-0d3a-4a1e-9c4f-2b8e5a6d1234","person_snapshot":{"city":"Manchester","country":"GB","id":"9f1c7b52-0d3a-4a1e-9c4f-2b8e5a6d1234","name":"Dana Whitfield","occupation":"Paediatric nurse","snapshotted_at":"2026-07-28T09:14:02.101000Z","type":"ai"},"reasoning_effort":"low","status":"open","task":{"id":null,"instructions":"Find the refund policy and start a return.","name":null,"revision":null},"turn_count":1,"turns":[{"created_at":"2026-07-28T09:14:19.402000Z","decision":{"action_name":"continue_to_payment","comment":"The total matches what was in my cart, so I am ready to pay.","felt_intensity":"moderate","sentiment":"Confident","status":"continue"},"frame_age_ms":312,"input_tokens":1204,"latency_ms":2841,"observation_kinds":["image"],"observation_url":null,"output_tokens":96,"turn_index":0,"validation_retries":0}],"updated_at":"2026-07-28T09:14:19.480000Z","workspace_id":"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"}}},"schema":{"type":"object","title":"SessionDetailResponse","description":"Full session state + a page of the ordered decision trace (GET).\n\nExactly the create/close body plus the trace, so a caller never has to\nreconcile two differently-shaped views of one session.","required":["turns","has_more","person_id","workspace_id","pacing","observation_retention","reasoning_effort","person_snapshot","id","status","task","environment","environment_id","environment_revision","environment_version_id","environment_version_label","decision_mode","turn_count","max_turns","created_by_api_key_id","accrued_credits","ended_reason","created_at","updated_at","ended_at"],"properties":{"accrued_credits":{"description":"This session's spend in credits (0 if it had no billable turns).","title":"Accrued Credits","type":"integer","isRequired":true,"uniqueKey":"accrued_credits","typeLabel":"integer"},"created_at":{"format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"created_by_api_key_id":{"oneOf":[{"type":"string","title":"Created By Api Key Id","format":"uuid","isRequired":true,"uniqueKey":"created_by_api_key_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Created By Api Key Id","isRequired":true,"uniqueKey":"created_by_api_key_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"created_by_api_key_id","typeLabel":"string\u003cuuid> | null"},"decision_mode":{"enum":["direct","intent"],"title":"DecisionMode","type":"string","isRequired":true,"uniqueKey":"decision_mode","typeLabel":"enum\u003cstring>"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","description":"When the session left `open` (UTC), stamped on the first terminal transition and never moved. Null while the session is open. This is the timestamp `sessions_ended` usage buckets on.","format":"date-time","isRequired":true,"uniqueKey":"ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Ended At","description":"When the session left `open` (UTC), stamped on the first terminal transition and never moved. Null while the session is open. This is the timestamp `sessions_ended` usage buckets on.","isRequired":true,"uniqueKey":"ended_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ended_at","typeLabel":"string\u003cdate-time> | null"},"ended_reason":{"oneOf":[{"type":"string","title":"Ended Reason","description":"Why the session ended, when that is finer than `status`: `credits_exhausted` or `plan_allowance_exhausted` (both end the session as `balance_exhausted`), or `spend_cap_reached`. Null for an ordinary ending. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","isRequired":true,"uniqueKey":"ended_reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ended Reason","description":"Why the session ended, when that is finer than `status`: `credits_exhausted` or `plan_allowance_exhausted` (both end the session as `balance_exhausted`), or `spend_cap_reached`. Null for an ordinary ending. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","isRequired":true,"uniqueKey":"ended_reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ended_reason","typeLabel":"string | null"},"environment":{"description":"The environment as frozen at create (name + kind snapshot).","properties":{"kind":{"description":"The kind of surface (e.g. `web`, `device`, `world`). Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","maxLength":40,"minLength":1,"title":"Kind","type":"string","isRequired":true,"uniqueKey":"environment.kind","typeLabel":"string"},"name":{"maxLength":120,"minLength":1,"title":"Name","type":"string","isRequired":true,"uniqueKey":"environment.name","typeLabel":"string"}},"required":["name","kind"],"title":"EnvironmentDescriptor","type":"object","isRequired":true,"uniqueKey":"environment","typeLabel":"EnvironmentDescriptor · object"},"environment_id":{"oneOf":[{"type":"string","title":"Environment Id","format":"uuid","isRequired":true,"uniqueKey":"environment_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Environment Id","isRequired":true,"uniqueKey":"environment_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environment_id","typeLabel":"string\u003cuuid> | null"},"environment_revision":{"oneOf":[{"type":"integer","title":"Environment Revision","isRequired":true,"uniqueKey":"environment_revision.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Environment Revision","isRequired":true,"uniqueKey":"environment_revision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environment_revision","typeLabel":"integer | null"},"environment_version_id":{"oneOf":[{"type":"string","title":"Environment Version Id","format":"uuid","isRequired":true,"uniqueKey":"environment_version_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Environment Version Id","isRequired":true,"uniqueKey":"environment_version_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environment_version_id","typeLabel":"string\u003cuuid> | null"},"environment_version_label":{"oneOf":[{"type":"string","title":"Environment Version Label","isRequired":true,"uniqueKey":"environment_version_label.oneOf.0","typeLabel":"string"},{"type":"null","title":"Environment Version Label","isRequired":true,"uniqueKey":"environment_version_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"environment_version_label","typeLabel":"string | null"},"id":{"format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"max_turns":{"title":"Max Turns","type":"integer","isRequired":true,"uniqueKey":"max_turns","typeLabel":"integer"},"status":{"enum":["open","completed","gave_up","closed","max_turns","spend_cap_reached","balance_exhausted"],"title":"SessionStatus","type":"string","description":"Session status. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"task":{"description":"The session's intent, frozen when it was created. A later edit to a registered task never changes it.","properties":{"id":{"oneOf":[{"type":"string","title":"Id","format":"uuid","isRequired":true,"uniqueKey":"task.id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Id","isRequired":true,"uniqueKey":"task.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.id","typeLabel":"string\u003cuuid> | null"},"instructions":{"title":"Instructions","type":"string","isRequired":true,"uniqueKey":"task.instructions","typeLabel":"string"},"name":{"oneOf":[{"type":"string","title":"Name","isRequired":true,"uniqueKey":"task.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","isRequired":true,"uniqueKey":"task.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.name","typeLabel":"string | null"},"revision":{"oneOf":[{"type":"integer","title":"Revision","description":"The registry row's revision at bind time. Two runs of one task are comparable within a revision of its content.","isRequired":true,"uniqueKey":"task.revision.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Revision","description":"The registry row's revision at bind time. Two runs of one task are comparable within a revision of its content.","isRequired":true,"uniqueKey":"task.revision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.revision","typeLabel":"integer | null"}},"required":["id","name","revision","instructions"],"title":"TaskSnapshot","type":"object","isRequired":true,"uniqueKey":"task","typeLabel":"TaskSnapshot · object"},"turn_count":{"title":"Turn Count","type":"integer","isRequired":true,"uniqueKey":"turn_count","typeLabel":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"observation_retention":{"description":"Retention window resolved at open: `none`, `30d`, `90d`, or `indefinite`. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","title":"Observation Retention","type":"string","isRequired":true,"uniqueKey":"observation_retention","typeLabel":"string"},"pacing":{"enum":["pause_on_decide","frame_on_demand","free_running"],"title":"PacingContract","type":"string","isRequired":true,"uniqueKey":"pacing","typeLabel":"enum\u003cstring>"},"person_id":{"oneOf":[{"type":"string","title":"Person Id","format":"uuid","isRequired":true,"uniqueKey":"person_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","title":"Person Id","isRequired":true,"uniqueKey":"person_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person_id","typeLabel":"string\u003cuuid> | null"},"person_snapshot":{"additionalProperties":true,"description":"The person as they were when the session was created, frozen onto the session.\n\nThis, not the live person, is what the session was run against: it stays readable and unchanged after the person is edited or deleted, which is what makes an old trace still mean something. `id` is the person's id at create time.\n\nAdditional keys may be present and more may be added over time; treat anything not listed here as unspecified rather than failing on it.","properties":{"id":{"format":"uuid","title":"Id","type":"string","isRequired":true,"uniqueKey":"person_snapshot.id","typeLabel":"string\u003cuuid>"},"name":{"title":"Name","type":"string","isRequired":true,"uniqueKey":"person_snapshot.name","typeLabel":"string"},"snapshotted_at":{"format":"date-time","title":"Snapshotted At","type":"string","isRequired":true,"uniqueKey":"person_snapshot.snapshotted_at","typeLabel":"string\u003cdate-time>"},"type":{"description":"Iteration execution type.","enum":["ai","human"],"title":"IterationType","type":"string","isRequired":true,"uniqueKey":"person_snapshot.type","typeLabel":"enum\u003cstring>"},"avatar_url":{"oneOf":[{"type":"string","title":"Avatar Url","uniqueKey":"person_snapshot.avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Avatar Url","uniqueKey":"person_snapshot.avatar_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.avatar_url","typeLabel":"string | null"},"bio":{"oneOf":[{"type":"string","title":"Bio","uniqueKey":"person_snapshot.bio.oneOf.0","typeLabel":"string"},{"type":"null","title":"Bio","uniqueKey":"person_snapshot.bio.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.bio","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","uniqueKey":"person_snapshot.city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"person_snapshot.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.city","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","title":"Country","uniqueKey":"person_snapshot.country.oneOf.0","typeLabel":"string"},{"type":"null","title":"Country","uniqueKey":"person_snapshot.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.country","typeLabel":"string | null"},"date_of_birth":{"oneOf":[{"type":"string","title":"Date Of Birth","format":"date","uniqueKey":"person_snapshot.date_of_birth.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","title":"Date Of Birth","uniqueKey":"person_snapshot.date_of_birth.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.date_of_birth","typeLabel":"string\u003cdate> | null"},"education_level":{"oneOf":[{"type":"string","title":"EducationLevel","enum":["less_than_secondary","secondary","some_post_secondary","vocational_or_associate","bachelor","graduate"],"uniqueKey":"person_snapshot.education_level.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.education_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.education_level","typeLabel":"enum\u003cstring> | null"},"employment_status":{"oneOf":[{"type":"string","title":"EmploymentStatus","enum":["employed_full_time","employed_part_time","self_employed","unemployed_seeking","student","homemaker","retired","unable_to_work","other"],"uniqueKey":"person_snapshot.employment_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.employment_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.employment_status","typeLabel":"enum\u003cstring> | null"},"gender":{"oneOf":[{"type":"string","title":"Gender","description":"Gender options for people.","enum":["male","female","non-binary","prefer_not_to_say"],"uniqueKey":"person_snapshot.gender.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.gender.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.gender","typeLabel":"enum\u003cstring> | null"},"household":{"oneOf":[{"type":"string","title":"Household","enum":["single","couple_no_kids","couple_with_kids","single_parent","shared_housing","adult_with_parents","multi_generational"],"uniqueKey":"person_snapshot.household.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.household.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.household","typeLabel":"enum\u003cstring> | null"},"income_level":{"oneOf":[{"type":"string","title":"IncomeLevel","enum":["lower","lower_middle","middle","upper_middle","upper","prefer_not_to_say"],"uniqueKey":"person_snapshot.income_level.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.income_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.income_level","typeLabel":"enum\u003cstring> | null"},"interests":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"person_snapshot.interests.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Interests","uniqueKey":"person_snapshot.interests.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Interests","uniqueKey":"person_snapshot.interests.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.interests","typeLabel":"string[] | null"},"languages":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"person_snapshot.languages.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Languages","uniqueKey":"person_snapshot.languages.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Languages","uniqueKey":"person_snapshot.languages.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.languages","typeLabel":"string[] | null"},"locale_type":{"oneOf":[{"type":"string","title":"LocaleType","enum":["urban","suburban","small_town","rural"],"uniqueKey":"person_snapshot.locale_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"person_snapshot.locale_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.locale_type","typeLabel":"enum\u003cstring> | null"},"occupation":{"oneOf":[{"type":"string","title":"Occupation","uniqueKey":"person_snapshot.occupation.oneOf.0","typeLabel":"string"},{"type":"null","title":"Occupation","uniqueKey":"person_snapshot.occupation.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.occupation","typeLabel":"string | null"},"snapshot_version":{"default":"2","enum":["1","2"],"title":"Snapshot Version","type":"string","uniqueKey":"person_snapshot.snapshot_version","typeLabel":"enum\u003cstring>"},"timezone":{"oneOf":[{"type":"string","title":"Timezone","uniqueKey":"person_snapshot.timezone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Timezone","uniqueKey":"person_snapshot.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"person_snapshot.timezone","typeLabel":"string | null"}},"required":["id","name","type","snapshotted_at"],"title":"PersonSnapshot","type":"object","isRequired":true,"uniqueKey":"person_snapshot","typeLabel":"PersonSnapshot · object"},"reasoning_effort":{"description":"Deliberation budget the session was opened with: `low`, `medium` or `high`. Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","title":"Reasoning Effort","type":"string","isRequired":true,"uniqueKey":"reasoning_effort","typeLabel":"string"},"workspace_id":{"format":"uuid","title":"Workspace Id","type":"string","isRequired":true,"uniqueKey":"workspace_id","typeLabel":"string\u003cuuid>"},"has_more":{"description":"True when more turns exist beyond this page (page with after_index).","title":"Has More","type":"boolean","isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"},"turns":{"items":{"description":"One recorded turn of the session's decision trace.\n\nThe observation is always recorded by reference (its block kinds and a sha256). Whether the FRAME itself survives is the session's retention window: when it does, `observation_url` carries a short-lived link to it.","properties":{"created_at":{"format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"decision":{"description":"What the person decided this turn, and how it felt.\n\n`action_name` names the action to execute, and is null when there is nothing to run: the person found no action that fits, or judged that none was needed. `comment`, `sentiment` and `felt_intensity` are the experiential half and are always present, including on a turn with no action. `status` says whether they intend to keep going.\n\n`intent`, `resolution` and `unmet_expectation` are populated only when the session runs in `intent` decision mode; they are null in `direct` mode.","properties":{"action_name":{"oneOf":[{"type":"string","title":"Action Name","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.action_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Action Name","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.action_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.action_name","typeLabel":"string | null"},"comment":{"title":"Comment","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.comment","typeLabel":"string"},"felt_intensity":{"description":"How strongly the person feels the labelled sentiment: `mild`, `moderate` or `strong`. An ordinal magnitude, reported alongside `sentiment` on every decision.\n\nOpen union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","enum":["mild","moderate","strong"],"title":"FeltIntensity","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.felt_intensity","typeLabel":"enum\u003cstring>"},"sentiment":{"description":"How the person felt while making this turn's decision.\n\nThe labels span the positive/negative and active/passive range, so disengagement reads differently from frustration. Reported with an ordinal `felt_intensity`.\n\nVALUES ARE CAPITALISED exactly as listed (`Confident`, not `confident`); match on the literal string. Open union: new labels may be added over time; clients must tolerate an unknown label rather than failing on it.","enum":["Delighted","Excited","Confident","Satisfied","Relieved","Neutral","Confused","Uncertain","Anxious","Frustrated","Disengaged"],"title":"Sentiment","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.sentiment","typeLabel":"enum\u003cstring>"},"status":{"enum":["continue","done","gave_up"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.status","typeLabel":"enum\u003cstring>"},"arguments":{"additionalProperties":true,"title":"Arguments","type":"object","uniqueKey":"turns.items.[INDEX].decision.arguments","typeLabel":"Arguments · object"},"intent":{"oneOf":[{"type":"string","title":"Intent","uniqueKey":"turns.items.[INDEX].decision.intent.oneOf.0","typeLabel":"string"},{"type":"null","title":"Intent","uniqueKey":"turns.items.[INDEX].decision.intent.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].decision.intent","typeLabel":"string | null"},"noticed":{"items":{"description":"Something the person picked up and expects to still know later, such as a price, a limit or a figure they worked out. Notes carry forward for the rest of the session.","properties":{"detail":{"description":"The thing itself, concretely enough to use later without looking it up again: '$25 per seat/month', 'free up to 3 seats', '400 seats x $25 = $10k/mo'.","maxLength":280,"title":"Detail","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.noticed.items.[INDEX].detail","typeLabel":"string"},"label":{"description":"Short name for the thing, in the person's own words (for example 'Business tier price'). Re-using a name replaces the note stored under it, which is how a person corrects something they misread.","maxLength":60,"title":"Label","type":"string","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision.noticed.items.[INDEX].label","typeLabel":"string"}},"required":["label","detail"],"title":"NoticedItem","type":"object","uniqueKey":"turns.items.[INDEX].decision.noticed.items.[INDEX]","typeLabel":"NoticedItem · object"},"title":"Noticed","type":"array","uniqueKey":"turns.items.[INDEX].decision.noticed","typeLabel":"NoticedItem · object[]"},"resolution":{"oneOf":[{"type":"string","title":"Resolution","description":"Resolver outcome (None in direct mode). Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","enum":["matched","no_match","none_needed"],"uniqueKey":"turns.items.[INDEX].decision.resolution.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Resolution","description":"Resolver outcome (None in direct mode). Open union: new values may be added over time; clients must tolerate unknown values rather than failing on them.","uniqueKey":"turns.items.[INDEX].decision.resolution.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].decision.resolution","typeLabel":"enum\u003cstring> | null"},"unmet_expectation":{"oneOf":[{"type":"string","title":"Unmet Expectation","uniqueKey":"turns.items.[INDEX].decision.unmet_expectation.oneOf.0","typeLabel":"string"},{"type":"null","title":"Unmet Expectation","uniqueKey":"turns.items.[INDEX].decision.unmet_expectation.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].decision.unmet_expectation","typeLabel":"string | null"}},"required":["action_name","comment","sentiment","felt_intensity","status"],"title":"TurnDecisionView","type":"object","isRequired":true,"uniqueKey":"turns.items.[INDEX].decision","typeLabel":"TurnDecisionView · object"},"frame_age_ms":{"oneOf":[{"type":"integer","title":"Frame Age Ms","isRequired":true,"uniqueKey":"turns.items.[INDEX].frame_age_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Frame Age Ms","isRequired":true,"uniqueKey":"turns.items.[INDEX].frame_age_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turns.items.[INDEX].frame_age_ms","typeLabel":"integer | null"},"input_tokens":{"oneOf":[{"type":"integer","title":"Input Tokens","isRequired":true,"uniqueKey":"turns.items.[INDEX].input_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Input Tokens","isRequired":true,"uniqueKey":"turns.items.[INDEX].input_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turns.items.[INDEX].input_tokens","typeLabel":"integer | null"},"latency_ms":{"title":"Latency Ms","type":"integer","isRequired":true,"uniqueKey":"turns.items.[INDEX].latency_ms","typeLabel":"integer"},"observation_kinds":{"items":{"type":"string","uniqueKey":"turns.items.[INDEX].observation_kinds.items.[INDEX]","typeLabel":"string"},"title":"Observation Kinds","type":"array","isRequired":true,"uniqueKey":"turns.items.[INDEX].observation_kinds","typeLabel":"string[]"},"output_tokens":{"oneOf":[{"type":"integer","title":"Output Tokens","isRequired":true,"uniqueKey":"turns.items.[INDEX].output_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Output Tokens","isRequired":true,"uniqueKey":"turns.items.[INDEX].output_tokens.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"turns.items.[INDEX].output_tokens","typeLabel":"integer | null"},"turn_index":{"title":"Turn Index","type":"integer","isRequired":true,"uniqueKey":"turns.items.[INDEX].turn_index","typeLabel":"integer"},"validation_retries":{"title":"Validation Retries","type":"integer","isRequired":true,"uniqueKey":"turns.items.[INDEX].validation_retries","typeLabel":"integer"},"observation_height":{"oneOf":[{"type":"integer","title":"Observation Height","uniqueKey":"turns.items.[INDEX].observation_height.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Observation Height","uniqueKey":"turns.items.[INDEX].observation_height.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].observation_height","typeLabel":"integer | null"},"observation_url":{"oneOf":[{"type":"string","title":"Observation Url","description":"Short-lived signed URL for this turn's retained observation frame, or null when no frame was retained (see the session's `observation_retention`). Expires shortly after issue, so do not store it.","uniqueKey":"turns.items.[INDEX].observation_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Observation Url","description":"Short-lived signed URL for this turn's retained observation frame, or null when no frame was retained (see the session's `observation_retention`). Expires shortly after issue, so do not store it.","uniqueKey":"turns.items.[INDEX].observation_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].observation_url","typeLabel":"string | null"},"observation_width":{"oneOf":[{"type":"integer","title":"Observation Width","uniqueKey":"turns.items.[INDEX].observation_width.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Observation Width","uniqueKey":"turns.items.[INDEX].observation_width.oneOf.1","typeLabel":"null"}],"uniqueKey":"turns.items.[INDEX].observation_width","typeLabel":"integer | null"}},"required":["turn_index","decision","observation_kinds","latency_ms","validation_retries","input_tokens","output_tokens","frame_age_ms","created_at"],"title":"SessionTurnView","type":"object","uniqueKey":"turns.items.[INDEX]","typeLabel":"SessionTurnView · object"},"title":"Turns","type":"array","isRequired":true,"uniqueKey":"turns","typeLabel":"SessionTurnView · object[]"}},"uniqueKey":"","typeLabel":"SessionDetailResponse · object"},"exampleType":"examples"}},"description":"Successful Response","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"examples"},"e12e73ee-2105-4cb9-946e-c06b4be9f378":{"content":{"application/json":{"schema":{"description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"docs_url","typeLabel":"string"}},"required":["detail","request_id"],"title":"Error","type":"object","uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","request_id":"\u003cstring>","docs_url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The bearer token is missing, malformed, unknown, or revoked (`detail.error_kind = 'invalid_api_key'`). One kind covers all four deliberately: distinguishing them would confirm which guesses are real keys.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"},"70298810-7961-4232-9fa9-7ad3e914afb5":{"content":{"application/json":{"schema":{"description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"docs_url","typeLabel":"string"}},"required":["detail","request_id"],"title":"Error","type":"object","uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","request_id":"\u003cstring>","docs_url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The API key lacks the `sessions:read` scope (`detail.error_kind = 'insufficient_scope'`, with `detail.required_scope = 'sessions:read'`). Mint a key that includes it; an ish user access token is unconstrained by scopes.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"},"adae3e8f-18d4-4428-921d-5966129d98e2":{"content":{"application/json":{"schema":{"description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"docs_url","typeLabel":"string"}},"required":["detail","request_id"],"title":"Error","type":"object","uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","request_id":"\u003cstring>","docs_url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The session was not found, or is not reachable with this credential. `detail.error_kind` is `session_not_found`.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"},"4a8156d8-1a8f-45fd-858d-2f277b287bc8":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"ValidationError","description":"Request body / parameter validation failure (HTTP 422). A field-level envelope so callers can pinpoint the offending field, value, and allowed values without parsing prose.","required":["error","error_code","status","retryable","detail","errors"],"properties":{"detail":{"title":"Detail","type":"string","isRequired":true,"uniqueKey":"oneOf.0.detail","typeLabel":"string"},"error":{"title":"Error","type":"string","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"error_code":{"description":"Stable machine code, e.g. `validation_error`.","title":"Error Code","type":"string","isRequired":true,"uniqueKey":"oneOf.0.error_code","typeLabel":"string"},"errors":{"items":{"description":"One field-level entry in a ValidationError envelope.","properties":{"loc":{"description":"Path to the offending field.","items":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.errors.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"oneOf.0.errors.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"oneOf.0.errors.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"title":"Location","type":"array","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].msg","typeLabel":"string"},"type":{"title":"Error Type","type":"string","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].type","typeLabel":"string"},"allowed_values":{"description":"For enum/literal failures, the accepted values.","items":{"oneOf":[{}],"uniqueKey":"oneOf.0.errors.items.[INDEX].allowed_values.items.[INDEX]","typeLabel":"any"},"title":"Allowed Values","type":"array","uniqueKey":"oneOf.0.errors.items.[INDEX].allowed_values","typeLabel":"any[]"},"input":{"oneOf":[{"type":"string","title":"Input","description":"Offending value (truncated); omitted for containers.","uniqueKey":"oneOf.0.errors.items.[INDEX].input.oneOf.0","typeLabel":"string"},{"type":"number","title":"Input","description":"Offending value (truncated); omitted for containers.","uniqueKey":"oneOf.0.errors.items.[INDEX].input.oneOf.1","typeLabel":"number"},{"type":"boolean","title":"Input","description":"Offending value (truncated); omitted for containers.","uniqueKey":"oneOf.0.errors.items.[INDEX].input.oneOf.2","typeLabel":"boolean"},{"type":"null","title":"Input","description":"Offending value (truncated); omitted for containers.","uniqueKey":"oneOf.0.errors.items.[INDEX].input.oneOf.3","typeLabel":"null"}],"uniqueKey":"oneOf.0.errors.items.[INDEX].input","typeLabel":"string | number | boolean | null"}},"required":["loc","msg","type"],"title":"FieldError","type":"object","uniqueKey":"oneOf.0.errors.items.[INDEX]","typeLabel":"FieldError · object"},"title":"Errors","type":"array","isRequired":true,"uniqueKey":"oneOf.0.errors","typeLabel":"FieldError · object[]"},"retryable":{"title":"Retryable","type":"boolean","isRequired":true,"uniqueKey":"oneOf.0.retryable","typeLabel":"boolean"},"status":{"title":"Status","type":"integer","isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"integer"},"suggestions":{"items":{"type":"string","uniqueKey":"oneOf.0.suggestions.items.[INDEX]","typeLabel":"string"},"title":"Suggestions","type":"array","uniqueKey":"oneOf.0.suggestions","typeLabel":"string[]"}},"uniqueKey":"oneOf.0","typeLabel":"ValidationError · object"},{"type":"object","title":"Error","description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","required":["detail","request_id"],"properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"oneOf.1.detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"oneOf.1.detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"oneOf.1.detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"oneOf.1.request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"oneOf.1.docs_url","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"Error · object"}],"uniqueKey":"","typeLabel":"ValidationError · object | Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>","error_code":"\u003cstring>","errors":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","allowed_values":["\u003cunknown>"],"input":"\u003cstring>"}],"retryable":true,"status":123,"suggestions":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Validation error. A request-shape failure uses the `ValidationError` envelope; a handler-raised domain-validation refusal uses the `Error` envelope.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"},"de6192e0-c274-4f31-a72a-b8181b367428":{"content":{"application/json":{"schema":{"description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"docs_url","typeLabel":"string"}},"required":["detail","request_id"],"title":"Error","type":"object","uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","request_id":"\u003cstring>","docs_url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"The API key's request rate limit is exceeded (`detail.error_kind = 'rate_limited'`). Transient: retry after the `Retry-After` interval, also echoed as `detail.retry_after_seconds`. Not applied to user access tokens.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"},"f6f78fe1-ab94-402d-96ae-a68e2cc087f6":{"content":{"application/json":{"schema":{"description":"Generic error envelope for 4xx/5xx responses other than request-shape validation.","properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"object","title":"Detail","description":"A human-readable message, OR a structured object carrying a machine-readable `error_kind` (e.g. `idempotency_conflict`, `turn_index_mismatch`, `decision_invalid`).","additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"Detail · object"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | Detail · object"},"request_id":{"description":"Correlation id; identical to the `X-Request-Id` response header. Quote it in support requests.","title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"docs_url":{"description":"Link to this error's entry in the error catalog. Present whenever `detail` carries a registered `error_kind`; absent on unclassified errors.","title":"Docs Url","type":"string","uniqueKey":"docs_url","typeLabel":"string"}},"required":["detail","request_id"],"title":"Error","type":"object","uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","request_id":"\u003cstring>","docs_url":"\u003cstring>"}}},"exampleType":"generated"}},"description":"An unexpected server-side failure. `detail.error_kind` is `session_actor_missing`. Not a state to handle: quote `request_id` and the kind in a bug report.","headers":{"X-Request-Id":{"description":"Per-response correlation id, present on EVERY response (success and error). Error bodies echo it as `request_id`.","schema":{"type":"string"}},"x-ratelimit-limit":{"description":"Ceiling for the rate-limit window this request charged. Present on responses made with an API key against a rate-limited operation, including the `429` itself; absent for user access tokens (which carry no per-key budget) and when the rate-limit backend could not be read.","schema":{"type":"integer"}},"x-ratelimit-remaining":{"description":"Requests left in that window AFTER this one was counted. Pace off this rather than waiting for a `429`.","schema":{"type":"integer"}},"x-ratelimit-reset":{"description":"**Seconds from now** until that window resets (a delta, NOT a Unix timestamp). Measured when the response is written. Omitted on the rare occasion the reset instant could not be read, while `limit` and `remaining` are still published.","schema":{"type":"integer"}}},"exampleType":"generated"}},"security":{"cdb72c81-10f0-4b0e-b865-b8f63d689bdd":{"bearerAuth":{"description":"Workspace API key as a bearer token: `Authorization: Bearer ish_sk_live_...`. Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: `sessions:run` (create a session, submit turns, close), `sessions:read` (read the session and its decision trace), `environments:read` and `environments:write` (manage the workspace's registered environments), `tasks:read` and `tasks:write` (manage the workspace's registered tasks), `people:read` and `people:write` (the people the workspace can run a session for), and `usage:read` (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with `sessions:run`, `sessions:read`, and `tasks:read` by default; every other scope must be requested, `people:read` and `usage:read` included. An ish user access token also works on the same header for personal scripts.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"22c3a961-b6d9-4922-b5aa-d0aac292aa39":{"description":"Production","url":"https://api.ishlabs.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Workspace API key as a bearer token: `Authorization: Bearer ish_sk_live_...`. Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: `sessions:run` (create a session, submit turns, close), `sessions:read` (read the session and its decision trace), `environments:read` and `environments:write` (manage the workspace's registered environments), `tasks:read` and `tasks:write` (manage the workspace's registered tasks), `people:read` and `people:write` (the people the workspace can run a session for), and `usage:read` (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with `sessions:run`, `sessions:read`, and `tasks:read` by default; every other scope must be requested, `people:read` and `usage:read` included. An ish user access token also works on the same header for personal scripts.","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key as a bearer token: `Authorization: Bearer ish_sk_live_...`. Keys are workspace-scoped machine principals minted in Settings > Developers (shown once at mint). Scopes: `sessions:run` (create a session, submit turns, close), `sessions:read` (read the session and its decision trace), `environments:read` and `environments:write` (manage the workspace's registered environments), `tasks:read` and `tasks:write` (manage the workspace's registered tasks), `people:read` and `people:write` (the people the workspace can run a session for), and `usage:read` (the workspace's own consumption, spend limits and rate-limit budgets). A key is minted with `sessions:run`, `sessions:read`, and `tasks:read` by default; every other scope must be requested, `people:read` and `usage:read` included. An ish user access token also works on the same header for personal scripts.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api/openapi.public.json"},"subdomain":"ish","siteName":"ish","title":"Get Session - ish","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T15:42:21.151Z","originalFileLocation":"api/reference/sessions/get-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The full session state + a cursor page of the decision trace. after_index returns turns strictly after that turn_index; limit (default 50, max 200) caps the page. has_more in the body signals whether to page again.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ish\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Session - ish\">\u003cmeta data-mint-head property=\"og:description\" content=\"The full session state + a cursor page of the decision trace. after_index returns turns strictly after that turn_index; limit (default 50, max 200) caps the page. has_more in the body signals whether to page again.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ish\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ishlabs.io/api/reference/sessions/get-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ish.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+Session\u0026amp;description=The+full+session+state+%2B+a+cursor+page+of+the+decision+trace.%0A%0A%60after_index%60+returns+turns+strictly+after+that+turn_index%3B+%60limit%60%0A%28default+50%2C+max+200%29+caps+th\u0026amp;theme=e052e8dabadef59794361480\u0026amp;signature=884fd5952e2166d26bbdb858e19a595b0ee99029fa5e46b1f54327862971643b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Session - ish\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The full session state + a cursor page of the decision trace. after_index returns turns strictly after that turn_index; limit (default 50, max 200) caps the page. has_more in the body signals whether to page again.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ish.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+Session\u0026amp;description=The+full+session+state+%2B+a+cursor+page+of+the+decision+trace.%0A%0A%60after_index%60+returns+turns+strictly+after+that+turn_index%3B+%60limit%60%0A%28default+50%2C+max+200%29+caps+th\u0026amp;theme=e052e8dabadef59794361480\u0026amp;signature=884fd5952e2166d26bbdb858e19a595b0ee99029fa5e46b1f54327862971643b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ish/pQaVEm2sa1ahpXnl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ish\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8623F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ishlabs.io/api/reference/sessions/get-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/reference/sessions/get-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ishlabs.io/#organization\",\"name\":\"ish\",\"url\":\"https://docs.ishlabs.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ish/4MaJn6-B7_NnPAml/logo/light.svg?fit=max\u0026auto=format\u0026n=4MaJn6-B7_NnPAml\u0026q=85\u0026s=f0edab6b74c19bec95794ee94d7270c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ishlabs.io#website\",\"name\":\"ish\",\"url\":\"https://docs.ishlabs.io\",\"publisher\":{\"@id\":\"https://docs.ishlabs.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ishlabs.io/api/reference/sessions/get-session#webpage\",\"url\":\"https://docs.ishlabs.io/api/reference/sessions/get-session\",\"name\":\"Get Session\",\"description\":\"The full session state + a cursor page of the decision trace. after_index returns turns strictly after that turn_index; limit (default 50, max 200) caps the page. has_more in the body signals whether to page again.\",\"dateModified\":\"2026-10-08T15:42:21.151Z\",\"isPartOf\":{\"@id\":\"https://docs.ishlabs.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ishlabs.io/api/reference/sessions/get-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ishlabs.io/api/reference/sessions/get-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.ishlabs.io/api/reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Session\",\"item\":\"https://docs.ishlabs.io/api/reference/sessions/get-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ishlabs.io/api/reference/sessions/get-session#apireference\",\"headline\":\"Get Session\",\"name\":\"Get Session\",\"description\":\"The full session state + a cursor page of the decision trace. after_index returns turns strictly after that turn_index; limit (default 50, max 200) caps the page. has_more in the body signals whether to page again.\",\"url\":\"https://docs.ishlabs.io/api/reference/sessions/get-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ishlabs.io/api/reference/sessions/get-session#webpage\"},\"dateModified\":\"2026-10-08T15:42:21.151Z\",\"publisher\":{\"@id\":\"https://docs.ishlabs.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ishlabs.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ish\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ish","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/ishlabs"},{"anchor":"ishlabs.io","icon":"globe","href":"https://ishlabs.io"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli/overview"}]},{"tab":"MCP Reference","pages":[{"title":"MCP Reference","href":"/mcp/overview"}]},{"tab":"API","groups":[{"group":"Get started","pages":[{"title":"The ish API","mode":"explanation","href":"/api/overview"},{"title":"Quickstart","mode":"tutorial","href":"/api/quickstart"},{"title":"Authentication","mode":"how-to","href":"/api/authentication"}]},{"group":"Core concepts","pages":[{"title":"Sessions and turns","mode":"explanation","href":"/api/concepts/sessions-and-turns"},{"title":"Observations","mode":"explanation","href":"/api/concepts/observations"},{"title":"The decide-only loop","mode":"explanation","href":"/api/concepts/decide-only-loop"},{"title":"Intent and resolution","mode":"explanation","href":"/api/concepts/intent-and-resolution"},{"title":"People","mode":"explanation","href":"/api/concepts/people"}]},{"group":"Guides","pages":[{"title":"Run the session loop","mode":"how-to","href":"/api/guides/session-loop"},{"title":"Author your environment","mode":"how-to","href":"/api/guides/environment-authoring"},{"title":"Score outcomes","mode":"how-to","href":"/api/guides/scoring-outcomes"},{"title":"Search people","mode":"how-to","href":"/api/guides/people-search"}]},{"group":"API reference","pages":[{"title":"API reference","mode":"reference","href":"/api/reference/introduction"},{"title":"Errors","mode":"reference","href":"/api/errors"},{"title":"Create Session","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/workspaces/{workspace_id}/sessions","href":"/api/reference/sessions/create-session"},{"title":"List Sessions","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/sessions","href":"/api/reference/sessions/list-sessions"},{"title":"Submit Turn","description":"Submit one observation + declared action set; get the person's choice.","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/sessions/{session_id}/turns","href":"/api/reference/sessions/submit-turn"},{"title":"Get Session","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/sessions/{session_id}","href":"/api/reference/sessions/get-session"},{"title":"Close Session","description":"Close an open session and return it (idempotent on an already-closed one).\n\nA POST on a `/close` subresource rather than `DELETE /sessions/{id}`:\nclosing is a state TRANSITION that settles the session's turns and leaves a\nreadable record, not a removal. DELETE promised an erasure this route never\nperformed, and it had no honest way to return the closed session's body.","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/sessions/{session_id}/close","href":"/api/reference/sessions/close-session"},{"title":"Create Environment","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/workspaces/{workspace_id}/environments","href":"/api/reference/environments/create-environment"},{"title":"List Environments","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/environments","href":"/api/reference/environments/list-environments"},{"title":"Get Environment","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/environments/{environment_id}","href":"/api/reference/environments/get-environment"},{"title":"Update Environment","deprecated":null,"version":null,"openapi":"/api/openapi.public.json patch /api/v1/environments/{environment_id}","href":"/api/reference/environments/update-environment"},{"title":"Delete Environment","deprecated":null,"version":null,"openapi":"/api/openapi.public.json delete /api/v1/environments/{environment_id}","href":"/api/reference/environments/delete-environment"},{"title":"Create Environment Version","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/environments/{environment_id}/versions","href":"/api/reference/environments/create-environment-version"},{"title":"List Environment Versions","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/environments/{environment_id}/versions","href":"/api/reference/environments/list-environment-versions"},{"title":"Get Environment Version","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/environment-versions/{version_id}","href":"/api/reference/environments/get-environment-version"},{"title":"Update Environment Version","deprecated":null,"version":null,"openapi":"/api/openapi.public.json patch /api/v1/environment-versions/{version_id}","href":"/api/reference/environments/update-environment-version"},{"title":"Delete Environment Version","deprecated":null,"version":null,"openapi":"/api/openapi.public.json delete /api/v1/environment-versions/{version_id}","href":"/api/reference/environments/delete-environment-version"},{"title":"Set Default Environment Version","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/environment-versions/{version_id}/set-default","href":"/api/reference/environments/set-default-environment-version"},{"title":"Create Task","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/workspaces/{workspace_id}/tasks","href":"/api/reference/tasks/create-task"},{"title":"List Tasks","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/tasks","href":"/api/reference/tasks/list-tasks"},{"title":"Get Task","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/tasks/{task_id}","href":"/api/reference/tasks/get-task"},{"title":"Update Task","deprecated":null,"version":null,"openapi":"/api/openapi.public.json patch /api/v1/tasks/{task_id}","href":"/api/reference/tasks/update-task"},{"title":"Delete Task","deprecated":null,"version":null,"openapi":"/api/openapi.public.json delete /api/v1/tasks/{task_id}","href":"/api/reference/tasks/delete-task"},{"title":"List People","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/people","href":"/api/reference/people/list-people"},{"title":"Search People","deprecated":null,"version":null,"openapi":"/api/openapi.public.json post /api/v1/workspaces/{workspace_id}/people/search","href":"/api/reference/people/search-people"},{"title":"Get Person","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/people/{person_id}","href":"/api/reference/people/get-person"},{"title":"Get People Counts","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/people/counts","href":"/api/reference/people/get-people-counts"},{"title":"Get People Schema","deprecated":null,"version":null,"openapi":"/api/openapi.public.json get /api/v1/workspaces/{workspace_id}/people/schema","href":"/api/reference/people/get-people-schema"}]},{"group":"Versioning and changes","pages":[{"title":"Versioning and deprecation","mode":"reference","href":"/api/versioning"},{"title":"Changelog","mode":"reference","href":"/api/changelog"}]}]},{"tab":"Help","pages":[{"title":"Help","href":"/help/troubleshooting"}]}]},"basePath":"","title":"Get Session - ish","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}