Auth: organization API key (read scope or higher) or a signed-in user.
Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.
Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.
Path Parameters
session_id
string
required
Query Parameters
from
integer
required
Required range: x >= 0
to
integer
required
Required range: x >= 0
whole
boolean
default:false
Response
Successful Response
id
string
required
index
integer
required
status
enum<string>
required
Available options:
allowed,
blocked,
escalated,
error,
running,
incomplete
started_at
string<date-time>
required
ended_at
string<date-time> | null
agent
AgentRef · object | null
An agent named on a telemetry read: the agent a turn ran on, or the
agent that called it. A deleted agent keeps its name (its row stays) and
says it is deleted; an id that names no agent of the organisation reads
its id as the name and says it is unknown (there is no agent to open).
Show child attributes
flows
SessionFlow · object[]
Show child attributes
steps
SessionStep · object[]
Show child attributes
step_count
integer
default:0
steps_loaded
boolean
default:true
steps_omitted
integer
default:0
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Xenovia","colors":{"primary":"#087D73","light":"#37AEA0","dark":"#087D73"},"logo":{"light":"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509","dark":"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509","href":"https://xenovia.io"},"favicon":"https://mintcdn.com/xenovia/RO5UF1Tk8L9B7yPt/logo/app-icon.svg?fit=max\u0026auto=format\u0026n=RO5UF1Tk8L9B7yPt\u0026q=85\u0026s=1c57a0b3bb29fc0be05f8d78f7657e78","background":{"color":{"light":"#FCFCFE","dark":"#050C16"}},"navbar":{"links":[{"href":"mailto:richard.loomis@xenovia.io","label":"Contact"}],"primary":{"type":"button","label":"Open Platform","href":"https://app.xenovia.io/"}},"footer":{"socials":{"x":"https://x.com/xenovia_io","linkedin":"https://www.linkedin.com/company/xenovia"}},"fonts":{"family":"Plus Jakarta Sans"},"integrations":{"posthog":{"apiKey":"phc_q4nUtwYn8CNyQYTfZChzYhYWhAVBWA7sYP5sTCcUbfMQ","sessionRecording":false}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xenovia","hasAudioNarration":false,"actualSubdomain":"xenovia","customDomains":["docs.xenovia.io"],"gitSource":{"type":"github","owner":"xenovia-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6afad66668b1903921ee8081"},"entitlements":{},"buildId":"6afadc6600a0506726303049","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API","count":121},{"language":"default","tag":"Docs","count":27},{"language":"default","tag":"Agents","count":21},{"language":"default","tag":"Providers","count":17},{"language":"default","tag":"Policies","count":16},{"language":"default","tag":"Organization","count":15},{"language":"default","tag":"Alerts","count":12},{"language":"default","tag":"Sessions and traces","count":12},{"language":"default","tag":"API keys","count":9},{"language":"default","tag":"Neon","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".dark img[src^=\"/icons/\"]{filter:invert(1) hue-rotate(180deg)}.xn-logos{display:grid;grid-template-columns:repeat(auto-fill, minmax(10rem, 1fr));gap:0.75rem}.xn-logo-card{display:flex;align-items:center;gap:0.75rem;padding:0.75rem 1rem;border:1px solid rgb(3 8 10 / 0.08);border-radius:0.75rem;font-size:0.875rem;font-weight:500;color:inherit;text-decoration:none}.xn-logo-card:hover{border-color:#087D73}.dark .xn-logo-card{border-color:rgb(252 252 254 / 0.09)}.dark .xn-logo-card:hover{border-color:#37AEA0}.xn-logo{width:1.5rem;height:1.5rem;object-fit:contain;flex:none;margin:0!important}.xn-dark{display:none}.dark .xn-dark{display:block}.dark .xn-light{display:none}"}],"page":{"pagePath":"api-reference/sessions/get-session-turns","slug":"/api-reference/sessions/get-session-turns","pageMetadata":{"title":"Get session turns","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nTurns `from` to `to` of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set `whole=true` to get every step of a long request rather than only its ends.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}/turns","href":"/api-reference/sessions/get-session-turns","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 strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Auth:\"\n }), \" organization API key (\", _jsx(_components.code, {\n children: \"read\"\n }), \" scope or higher) or a signed-in user.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Turns \", _jsx(_components.code, {\n children: \"from\"\n }), \" to \", _jsx(_components.code, {\n children: \"to\"\n }), \" of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set \", _jsx(_components.code, {\n children: \"whole=true\"\n }), \" to get every step of a long request rather than only its ends.\"]\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 turns","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nTurns `from` to `to` of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set `whole=true` to get every step of a long request rather than only its ends.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}/turns","href":"/api-reference/sessions/get-session-turns","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["sessions"],"summary":"Get session turns","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nTurns `from` to `to` of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set `whole=true` to get every step of a long request rather than only its ends.","operationId":"get_session_turns_route_api_v1_sessions__session_id__turns_get","parameters":["d83721c9-224c-4575-a820-ba4efbe08a05","587ae24d-ec66-46ed-8d64-521ba7ec159c","f7652d4a-37bd-4f67-9d71-848033cf9ca1","d8b5918a-7a89-4602-9a1a-835c562794e7"],"responses":{"200":"dc789927-ffe3-4f84-bf9d-c9239d3d564d","422":"41c5a70c-a352-4bcc-822f-44abfcb10e79"},"method":"get","type":"path","servers":["e7c82bd9-57a1-44c9-a36f-fd46ab7f418e"],"security":["c3faa7b4-ffd0-4ea7-bc9e-f88dd598b349"],"path":"/api/v1/sessions/{session_id}/turns","baseUrlOptions":["https://cp.xenovia.io"],"title":"Get session turns","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d83721c9-224c-4575-a820-ba4efbe08a05":{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"587ae24d-ec66-46ed-8d64-521ba7ec159c":{"name":"from","in":"query","required":true,"schema":{"type":"integer","minimum":0,"title":"From","isRequired":true,"uniqueKey":"","typeLabel":"integer"}},"f7652d4a-37bd-4f67-9d71-848033cf9ca1":{"name":"to","in":"query","required":true,"schema":{"type":"integer","minimum":0,"title":"To","isRequired":true,"uniqueKey":"","typeLabel":"integer"}},"d8b5918a-7a89-4602-9a1a-835c562794e7":{"name":"whole","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Whole","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}}},"responses":{"dc789927-ffe3-4f84-bf9d-c9239d3d564d":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"index":{"type":"integer","title":"Index","isRequired":true,"uniqueKey":"items.[INDEX].index","typeLabel":"integer"},"status":{"type":"string","enum":["allowed","blocked","escalated","error","running","incomplete"],"title":"SessionStatus","isRequired":true,"uniqueKey":"items.[INDEX].status","typeLabel":"enum\u003cstring>"},"started_at":{"type":"string","format":"date-time","title":"Started At","isRequired":true,"uniqueKey":"items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","format":"date-time","uniqueKey":"items.[INDEX].ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Ended At","uniqueKey":"items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].ended_at","typeLabel":"string\u003cdate-time> | null"},"agent":{"oneOf":[{"type":"object","title":"AgentRef","description":"An agent named on a telemetry read: the agent a turn ran on, or the\nagent that called it. A deleted agent keeps its name (its row stays) and\nsays it is deleted; an id that names no agent of the organisation reads\nits id as the name and says it is unknown (there is no agent to open).","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"items.[INDEX].agent.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"items.[INDEX].agent.oneOf.0.name","typeLabel":"string"},"deleted":{"type":"boolean","title":"Deleted","default":false,"uniqueKey":"items.[INDEX].agent.oneOf.0.deleted","typeLabel":"boolean"},"unknown":{"type":"boolean","title":"Unknown","default":false,"uniqueKey":"items.[INDEX].agent.oneOf.0.unknown","typeLabel":"boolean"}},"uniqueKey":"items.[INDEX].agent.oneOf.0","typeLabel":"AgentRef · object"},{"type":"null","uniqueKey":"items.[INDEX].agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].agent","typeLabel":"AgentRef · object | null"},"flows":{"items":{"properties":{"trace_id":{"type":"string","title":"Trace Id","isRequired":true,"uniqueKey":"items.[INDEX].flows.items.[INDEX].trace_id","typeLabel":"string"},"sub_agent":{"oneOf":[{"type":"string","title":"Sub Agent","uniqueKey":"items.[INDEX].flows.items.[INDEX].sub_agent.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sub Agent","uniqueKey":"items.[INDEX].flows.items.[INDEX].sub_agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].flows.items.[INDEX].sub_agent","typeLabel":"string | null"},"caller_agent":{"oneOf":[{"type":"object","title":"AgentRef","description":"An agent named on a telemetry read: the agent a turn ran on, or the\nagent that called it. A deleted agent keeps its name (its row stays) and\nsays it is deleted; an id that names no agent of the organisation reads\nits id as the name and says it is unknown (there is no agent to open).","required":["id","name"],"properties":{"id":{"type":"string","format":"uuid","title":"Id","isRequired":true,"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.0.name","typeLabel":"string"},"deleted":{"type":"boolean","title":"Deleted","default":false,"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.0.deleted","typeLabel":"boolean"},"unknown":{"type":"boolean","title":"Unknown","default":false,"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.0.unknown","typeLabel":"boolean"}},"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.0","typeLabel":"AgentRef · object"},{"type":"null","uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_agent","typeLabel":"AgentRef · object | null"},"caller_sub_agent":{"oneOf":[{"type":"string","title":"Caller Sub Agent","uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_sub_agent.oneOf.0","typeLabel":"string"},{"type":"null","title":"Caller Sub Agent","uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_sub_agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].flows.items.[INDEX].caller_sub_agent","typeLabel":"string | null"},"workflow_id":{"oneOf":[{"type":"string","title":"Workflow Id","uniqueKey":"items.[INDEX].flows.items.[INDEX].workflow_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Workflow Id","uniqueKey":"items.[INDEX].flows.items.[INDEX].workflow_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].flows.items.[INDEX].workflow_id","typeLabel":"string | null"},"agent_depth":{"type":"integer","title":"Agent Depth","default":0,"uniqueKey":"items.[INDEX].flows.items.[INDEX].agent_depth","typeLabel":"integer"}},"type":"object","required":["trace_id"],"title":"SessionFlow","description":"Who made requests of a turn: the inline sub-agent and, on a linked\ncall, the calling agent and its inline sub-agent, with the requests'\ntrace id. One entry per distinct identity under a trace id, read from\neach row's own identity, so two identities are never merged. The trace id\nis not unique among a turn's flows: with a session id and no trace flow\nid the runtime names every request under a turn number\n``{session_id}:{turn}``, and two requests with the same identity there\nread as one flow (docs/sub-agents.md).","uniqueKey":"items.[INDEX].flows.items.[INDEX]","typeLabel":"SessionFlow · object"},"type":"array","title":"Flows","uniqueKey":"items.[INDEX].flows","typeLabel":"SessionFlow · object[]"},"steps":{"items":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"items.[INDEX].steps.items.[INDEX].id","typeLabel":"string"},"kind":{"type":"string","enum":["received","intent","policy","llm","tool","retrieval","embedding","guardrail","finished","escalation","other"],"title":"SessionStepKind","isRequired":true,"uniqueKey":"items.[INDEX].steps.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"items.[INDEX].steps.items.[INDEX].name","typeLabel":"string"},"status":{"type":"string","enum":["allowed","blocked","escalated","error","running","incomplete"],"title":"SessionStatus","isRequired":true,"uniqueKey":"items.[INDEX].steps.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"started_at":{"type":"string","format":"date-time","title":"Started At","isRequired":true,"uniqueKey":"items.[INDEX].steps.items.[INDEX].started_at","typeLabel":"string\u003cdate-time>"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","format":"date-time","uniqueKey":"items.[INDEX].steps.items.[INDEX].ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Ended At","uniqueKey":"items.[INDEX].steps.items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].steps.items.[INDEX].ended_at","typeLabel":"string\u003cdate-time> | null"},"duration_ms":{"oneOf":[{"type":"integer","title":"Duration Ms","uniqueKey":"items.[INDEX].steps.items.[INDEX].duration_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Duration Ms","uniqueKey":"items.[INDEX].steps.items.[INDEX].duration_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].steps.items.[INDEX].duration_ms","typeLabel":"integer | null"},"parent_id":{"oneOf":[{"type":"string","title":"Parent Id","uniqueKey":"items.[INDEX].steps.items.[INDEX].parent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Parent Id","uniqueKey":"items.[INDEX].steps.items.[INDEX].parent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].steps.items.[INDEX].parent_id","typeLabel":"string | null"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes","uniqueKey":"items.[INDEX].steps.items.[INDEX].attributes","typeLabel":"Attributes · object"}},"type":"object","required":["id","kind","name","status","started_at"],"title":"SessionStep","uniqueKey":"items.[INDEX].steps.items.[INDEX]","typeLabel":"SessionStep · object"},"type":"array","title":"Steps","uniqueKey":"items.[INDEX].steps","typeLabel":"SessionStep · object[]"},"step_count":{"type":"integer","title":"Step Count","default":0,"uniqueKey":"items.[INDEX].step_count","typeLabel":"integer"},"steps_loaded":{"type":"boolean","title":"Steps Loaded","default":true,"uniqueKey":"items.[INDEX].steps_loaded","typeLabel":"boolean"},"steps_omitted":{"type":"integer","title":"Steps Omitted","default":0,"uniqueKey":"items.[INDEX].steps_omitted","typeLabel":"integer"}},"type":"object","required":["id","index","status","started_at"],"title":"SessionTurn","description":"One agent's turn. The runtime numbers turns per session, so when\nseveral agents share a session (an orchestrator's X-Xenovia-Session-Id)\ntheir requests can share a turn number; each agent's requests under that\nnumber are a turn of their own, and the id then names the agent\n(``{session_id}:{index}:{agent_id}``; ``{session_id}:{index}`` otherwise).\nA turn's tool-result continuations are further requests of it: ``flows``\nsays who made each.","uniqueKey":"items.[INDEX]","typeLabel":"SessionTurn · object"},"title":"Response Get Session Turns Route Api V1 Sessions Session Id Turns Get","uniqueKey":"","typeLabel":"SessionTurn · object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"\u003cstring>","index":123,"status":"allowed","started_at":"2023-11-07T05:31:56Z","ended_at":"2023-11-07T05:31:56Z","agent":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","deleted":false,"unknown":false},"flows":[{"trace_id":"\u003cstring>","sub_agent":"\u003cstring>","caller_agent":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","deleted":false,"unknown":false},"caller_sub_agent":"\u003cstring>","workflow_id":"\u003cstring>","agent_depth":0}],"steps":[{"id":"\u003cstring>","kind":"received","name":"\u003cstring>","status":"allowed","started_at":"2023-11-07T05:31:56Z","ended_at":"2023-11-07T05:31:56Z","duration_ms":123,"parent_id":"\u003cstring>","attributes":{}}],"step_count":0,"steps_loaded":true,"steps_omitted":0}]}},"exampleType":"generated"}},"exampleType":"generated"},"41c5a70c-a352-4bcc-822f-44abfcb10e79":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c3faa7b4-ffd0-4ea7-bc9e-f88dd598b349":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"e7c82bd9-57a1-44c9-a36f-fd46ab7f418e":{"url":"https://cp.xenovia.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token: an organization API key (`ak_…`) created under Settings → API Keys, or a dashboard user session token. Agent keys (`xe_…`) are not accepted here. Endpoints marked as user-only in their description reject organization keys with `403`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://cp.xenovia.io/openapi.json"},"subdomain":"xenovia","siteName":"Xenovia","title":"Get session turns - Xenovia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T10:14:37.208Z","originalFileLocation":"api-reference/sessions/get-session-turns.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=\"Auth: organization API key (read scope or higher) or a signed-in user. Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Xenovia\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get session turns - Xenovia\">\u003cmeta data-mint-head property=\"og:description\" content=\"Auth: organization API key (read scope or higher) or a signed-in user. Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xenovia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.xenovia.io/api-reference/sessions/get-session-turns\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xenovia.mintlify.site/_mintlify/api/og/v2?division=Sessions+and+traces\u0026amp;title=Get+session+turns\u0026amp;description=**Auth%3A**+organization+API+key+%28%60read%60+scope+or+higher%29+or+a+signed-in+user.%0A%0ATurns+%60from%60+to+%60to%60+of+a+session+with+their+steps%2C+at+most+50+per+call%2C+for+a+lon\u0026amp;theme=55bac7760962f1669e7a9bdc\u0026amp;signature=cea116e27ac38b525ffa283856b8d129a0d0e5447f30a9dc7acae0a2b79e7240\">\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 turns - Xenovia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Auth: organization API key (read scope or higher) or a signed-in user. Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xenovia.mintlify.site/_mintlify/api/og/v2?division=Sessions+and+traces\u0026amp;title=Get+session+turns\u0026amp;description=**Auth%3A**+organization+API+key+%28%60read%60+scope+or+higher%29+or+a+signed-in+user.%0A%0ATurns+%60from%60+to+%60to%60+of+a+session+with+their+steps%2C+at+most+50+per+call%2C+for+a+lon\u0026amp;theme=55bac7760962f1669e7a9bdc\u0026amp;signature=cea116e27ac38b525ffa283856b8d129a0d0e5447f30a9dc7acae0a2b79e7240\">\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/xenovia/qfN_5rBm5NpbpNma/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xenovia\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#087D73\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.xenovia.io/api-reference/sessions/get-session-turns\">\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-turns.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.xenovia.io/#organization\",\"name\":\"Xenovia\",\"url\":\"https://docs.xenovia.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xenovia/fXYbfbUZbT5Ajr9c/logo/xenovia-logo.svg?fit=max\u0026auto=format\u0026n=fXYbfbUZbT5Ajr9c\u0026q=85\u0026s=35e1d4d64610ecc78b840c284519c509\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.xenovia.io#website\",\"name\":\"Xenovia\",\"url\":\"https://docs.xenovia.io\",\"publisher\":{\"@id\":\"https://docs.xenovia.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns#webpage\",\"url\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns\",\"name\":\"Get session turns\",\"description\":\"Auth: organization API key (read scope or higher) or a signed-in user. Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.\",\"dateModified\":\"2026-11-16T10:14:37.208Z\",\"isPartOf\":{\"@id\":\"https://docs.xenovia.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sessions and traces\",\"item\":\"https://docs.xenovia.io/api-reference/sessions/list-sessions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get session turns\",\"item\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns#apireference\",\"headline\":\"Get session turns\",\"name\":\"Get session turns\",\"description\":\"Auth: organization API key (read scope or higher) or a signed-in user. Turns from to to of a session with their steps, at most 50 per call, for a long session whose detail returns only a window of turns. Set whole=true to get every step of a long request rather than only its ends.\",\"url\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns\",\"mainEntityOfPage\":{\"@id\":\"https://docs.xenovia.io/api-reference/sessions/get-session-turns#webpage\"},\"dateModified\":\"2026-11-16T10:14:37.208Z\",\"publisher\":{\"@id\":\"https://docs.xenovia.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.xenovia.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xenovia\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Xenovia\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/sessions/get-session-turns.md","siteName":"Xenovia","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Docs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/book-open.svg","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"Xenovia SDK","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/lightning.svg","pages":[{"title":"Xenovia SDK","href":"/sdk/quickstart"}]},{"tab":"API","icon":"https://mintlify.s3.us-west-1.amazonaws.com/xenovia/icons/brackets-curly.svg","groups":[{"group":"Core API","pages":[{"title":"API Introduction","icon":"code","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Errors and Limits","icon":"triangle-exclamation","href":"/api-reference/errors-and-limits"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents","href":"/api-reference/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}","href":"/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}","href":"/api-reference/agents/delete-agent"},{"title":"Activate agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/activate","href":"/api-reference/agents/activate-agent"},{"title":"Deactivate agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/deactivate","href":"/api-reference/agents/deactivate-agent"},{"title":"Get policy input schema","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/schema/policy-input","href":"/api-reference/agents/get-policy-input-schema"},{"title":"Replace an agent's fallback providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/fallbacks","href":"/api-reference/agents/replace-an-agents-fallback-providers"},{"title":"How an agent's model requests were routed","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/routing-stats","href":"/api-reference/agents/how-an-agents-model-requests-were-routed"},{"title":"Get agent readiness","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/readiness","href":"/api-reference/agents/get-agent-readiness"},{"title":"List suggested checks","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/check-suggestions","href":"/api-reference/agents/list-suggested-checks"},{"title":"Get hosted tool allow-list","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/hosted-tools","href":"/api-reference/agents/get-hosted-tool-allow-list"},{"title":"Replace hosted tool allow-list","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/hosted-tools","href":"/api-reference/agents/replace-hosted-tool-allow-list"},{"title":"List config snapshots","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/config-snapshots","href":"/api-reference/agents/list-config-snapshots"},{"title":"Get config snapshot","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/config-snapshots/{config_version}","href":"/api-reference/agents/get-config-snapshot"}]},{"group":"Sub-agents","pages":[{"title":"List sub-agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/sub-agents","href":"/api-reference/agents/list-sub-agents"},{"title":"Add sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/sub-agents","href":"/api-reference/agents/add-sub-agent"},{"title":"Update inline sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}","href":"/api-reference/agents/update-inline-sub-agent"},{"title":"Delete sub-agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}","href":"/api-reference/agents/delete-sub-agent"},{"title":"List parent agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/parents","href":"/api-reference/agents/list-parent-agents"}]},{"group":"Neon","pages":[{"title":"Get Neon settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/neon","href":"/api-reference/agents/get-neon-settings"},{"title":"Update Neon settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/agents/{agent_id}/neon","href":"/api-reference/agents/update-neon-settings"},{"title":"Explain Neon decision","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/neon/decisions/{decision_id}/explain","href":"/api-reference/agents/explain-neon-decision"},{"title":"List capabilities","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/capabilities","href":"/api-reference/agents/list-capabilities"},{"title":"Create capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/capabilities","href":"/api-reference/agents/create-capability"},{"title":"Update capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/capabilities/{capability_id}","href":"/api-reference/agents/update-capability"},{"title":"Delete capability","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/capabilities/{capability_id}","href":"/api-reference/agents/delete-capability"}]},{"group":"Guardrails","pages":[{"title":"List guardrails","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/slm-checks","href":"/api-reference/agents/list-guardrails"},{"title":"Create guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/slm-checks","href":"/api-reference/agents/create-guardrail"},{"title":"Update guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/agents/{agent_id}/slm-checks/{check_id}","href":"/api-reference/agents/update-guardrail"},{"title":"Delete guardrail","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/slm-checks/{check_id}","href":"/api-reference/agents/delete-guardrail"}]},{"group":"Providers","pages":[{"title":"List providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers","href":"/api-reference/providers/list-providers"},{"title":"Provider connection health","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/health","href":"/api-reference/providers/provider-connection-health"},{"title":"Create provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers","href":"/api-reference/providers/create-provider"},{"title":"Get provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/{provider_id}","href":"/api-reference/providers/get-provider"},{"title":"Update provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/providers/{provider_id}","href":"/api-reference/providers/update-provider"},{"title":"Delete provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/providers/{provider_id}","href":"/api-reference/providers/delete-provider"},{"title":"List agent providers","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/providers","href":"/api-reference/providers/list-agent-providers"},{"title":"Attach provider to agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/providers/{provider_id}","href":"/api-reference/providers/attach-provider-to-agent"},{"title":"Detach provider from agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/providers/{provider_id}","href":"/api-reference/providers/detach-provider-from-agent"},{"title":"Get provider catalog","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/provider-catalog","href":"/api-reference/providers/get-provider-catalog"},{"title":"List provider models","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/providers/{provider_id}/models","href":"/api-reference/providers/list-provider-models"},{"title":"List models for an unsaved provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/models/draft","href":"/api-reference/providers/list-models-for-an-unsaved-provider"},{"title":"List catalog models","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/provider-catalog/{provider_id}/models","href":"/api-reference/providers/list-catalog-models"},{"title":"Test unsaved provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/test","href":"/api-reference/providers/test-unsaved-provider"},{"title":"Test provider","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/providers/{provider_id}/test","href":"/api-reference/providers/test-provider"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies","href":"/api-reference/policies/list-policies"},{"title":"Create policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies","href":"/api-reference/policies/create-policy"},{"title":"List policy inventory","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/inventory","href":"/api-reference/policies/list-policy-inventory"},{"title":"Get policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}","href":"/api-reference/policies/get-policy"},{"title":"Update policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/policies/{policy_id}","href":"/api-reference/policies/update-policy"},{"title":"Delete policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/policies/{policy_id}","href":"/api-reference/policies/delete-policy"},{"title":"Disable policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies/{policy_id}/disable","href":"/api-reference/policies/disable-policy"},{"title":"Enable policy","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policies/{policy_id}/enable","href":"/api-reference/policies/enable-policy"},{"title":"List agent policies","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/policies","href":"/api-reference/policies/list-agent-policies"},{"title":"Attach policy to agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/policies/{policy_id}","href":"/api-reference/policies/attach-policy-to-agent"},{"title":"Detach policy from agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/policies/{policy_id}","href":"/api-reference/policies/detach-policy-from-agent"},{"title":"Set policy agents","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/policies/{policy_id}/agents","href":"/api-reference/policies/set-policy-agents"},{"title":"Set policy mode for an agent","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json put /api/v1/policies/{policy_id}/agents/{agent_id}/mode","href":"/api-reference/policies/set-policy-mode-for-an-agent"},{"title":"List policy versions","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/versions","href":"/api-reference/policies/list-policy-versions"},{"title":"Get policy stats","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/stats","href":"/api-reference/policies/get-policy-stats"},{"title":"List policy activity","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policies/{policy_id}/activity","href":"/api-reference/policies/list-policy-activity"}]},{"group":"Policy templates","pages":[{"title":"List policy templates","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policy-templates","href":"/api-reference/policies/list-policy-templates"},{"title":"Get policy template","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/policy-templates/{template_id}","href":"/api-reference/policies/get-policy-template"},{"title":"Instantiate policy template","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/policy-templates/{template_id}/instantiate","href":"/api-reference/policies/instantiate-policy-template"},{"title":"List recommended templates","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/policy-templates/recommended","href":"/api-reference/policies/list-recommended-templates"}]},{"group":"API keys","pages":[{"title":"List organization API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/keys","href":"/api-reference/api-keys/list-organization-api-keys"},{"title":"Create organization API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/orgs/{org_id}/keys","href":"/api-reference/api-keys/create-organization-api-key"},{"title":"List agent API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/keys","href":"/api-reference/api-keys/list-agent-api-keys"},{"title":"Create agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/keys","href":"/api-reference/api-keys/create-agent-api-key"},{"title":"Revoke organization API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/orgs/{org_id}/keys/{key}","href":"/api-reference/api-keys/revoke-organization-api-key"},{"title":"Revoke agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/keys/{key}","href":"/api-reference/api-keys/revoke-agent-api-key"},{"title":"List sub-agent API keys","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys","href":"/api-reference/agents/list-sub-agent-api-keys"},{"title":"Create sub-agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys","href":"/api-reference/agents/create-sub-agent-api-key"},{"title":"Revoke sub-agent API key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/agents/{agent_id}/sub-agents/{sub_agent_id}/keys/{key}","href":"/api-reference/agents/revoke-sub-agent-api-key"}]},{"group":"Sessions and traces","pages":[{"title":"List sessions","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions","href":"/api-reference/sessions/list-sessions"},{"title":"List trace records","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces","href":"/api-reference/sessions/list-trace-records"},{"title":"List workflows","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/workflows","href":"/api-reference/sessions/list-workflows"},{"title":"Get session","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}","href":"/api-reference/sessions/get-session"},{"title":"Get agent activity","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/agent-activity","href":"/api-reference/sessions/get-agent-activity"},{"title":"Get trace stats","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/stats","href":"/api-reference/sessions/get-trace-stats"},{"title":"Get workflow","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/workflows/{workflow_id}","href":"/api-reference/sessions/get-workflow"},{"title":"Get trace flow","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nAll steps of one turn. Accepts a turn id or a run id.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/flow","href":"/api-reference/sessions/get-trace-flow"},{"title":"Get session turns","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/sessions/{session_id}/turns","href":"/api-reference/sessions/get-session-turns"},{"title":"Get trace overview","description":"**Auth:** organization API key (`read` scope or higher) or a signed-in user.\n\nVerdict, evaluation, token and latency totals per `interval` (`hour`, `six_hours` or `day`), plus activity per agent. Filter with `agent_id`, `from` and `to`.","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/overview","href":"/api-reference/sessions/get-trace-overview"},{"title":"Get run payload","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/runs/{run_id}/payload","href":"/api-reference/sessions/get-run-payload"},{"title":"Get run content","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/traces/{trace_id}/runs/{run_id}/content","href":"/api-reference/sessions/get-run-content"}]},{"group":"Alerts","pages":[{"title":"List in-app notifications","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alert-notifications","href":"/api-reference/alerts/list-in-app-notifications"},{"title":"List alert rules","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alert-rules","href":"/api-reference/alerts/list-alert-rules"},{"title":"Create alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/alert-rules","href":"/api-reference/alerts/create-alert-rule"},{"title":"List alert events","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alerts","href":"/api-reference/alerts/list-alert-events"},{"title":"Get notification settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/notification-settings","href":"/api-reference/alerts/get-notification-settings"},{"title":"Update notification settings","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/notification-settings","href":"/api-reference/alerts/update-notification-settings"},{"title":"Mark all notifications read","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/alert-notifications/read-all","href":"/api-reference/alerts/mark-all-notifications-read"},{"title":"Update alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/alert-rules/{rule_id}","href":"/api-reference/alerts/update-alert-rule"},{"title":"Delete alert rule","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/alert-rules/{rule_id}","href":"/api-reference/alerts/delete-alert-rule"},{"title":"Get alert event","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/alerts/{event_id}","href":"/api-reference/alerts/get-alert-event"},{"title":"Send test notification","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/notification-settings/test","href":"/api-reference/alerts/send-test-notification"},{"title":"Mark notification read","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/alert-notifications/{notification_id}/read","href":"/api-reference/alerts/mark-notification-read"}]},{"group":"Organization","pages":[{"title":"Get organization","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}","href":"/api-reference/organizations/get-organization"},{"title":"Update onboarding state","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/orgs/{org_id}","href":"/api-reference/organizations/update-onboarding-state"},{"title":"List audit logs","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs","href":"/api-reference/audit-logs/list-audit-logs"},{"title":"Verify audit chain","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/verify","href":"/api-reference/audit-logs/verify-audit-chain"},{"title":"Export audit chain","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/export","href":"/api-reference/audit-logs/export-audit-chain"},{"title":"Get audit signing key","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/audit-logs/signing-key","href":"/api-reference/audit-logs/get-audit-signing-key"},{"title":"List members","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/users","href":"/api-reference/users/list-members"},{"title":"Add member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/orgs/{org_id}/users","href":"/api-reference/users/add-member"},{"title":"Get member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/get-member"},{"title":"Update member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/update-member"},{"title":"Remove member","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json delete /api/v1/orgs/{org_id}/users/{user_id}","href":"/api-reference/users/remove-member"}]},{"group":"Deployments (hybrid)","pages":[{"title":"List deployments","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments","href":"/api-reference/deployments/list-deployments"},{"title":"Create deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments","href":"/api-reference/deployments/create-deployment"},{"title":"Get deployment health","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments/health","href":"/api-reference/deployments/get-deployment-health"},{"title":"Get deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json get /api/v1/deployments/{deployment_id}","href":"/api-reference/deployments/get-deployment"},{"title":"Update deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json patch /api/v1/deployments/{deployment_id}","href":"/api-reference/deployments/update-deployment"},{"title":"Revoke deployment","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments/{deployment_id}/revoke","href":"/api-reference/deployments/revoke-deployment"},{"title":"Rotate deployment credential","deprecated":null,"version":null,"openapi":"https://cp.xenovia.io/openapi.json post /api/v1/deployments/{deployment_id}/rotate","href":"/api-reference/deployments/rotate-deployment-credential"}]}]}]},"basePath":"","title":"Get session turns - Xenovia","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}