An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.
Path Parameters
id
string
required
A unique ID that starts with app_.
Pattern: ^app_[0-9A-Za-z]{24}$
Example:
"app_Zj7XhMgplmTJcp5Dk4vcYuk0"
session_id
string
required
A unique ID that starts with ses_.
Pattern: ^ses_[0-9A-Za-z]{24}$
Example:
"ses_Zj7XhMgplmTJcp5Dk4vcYuk0"
Query Parameters
limit
integer
default:50
The maximum number of turns to return.
Required range: 1 <= x <= 100
cursor
string
Where to start: the next_cursor of the page before, listed with the same sort. Without it, the list starts with the first turns.
Required string length: 1 - 4096
sort
string
default:created_at
A comma-separated list of fields to sort by: created_at. Each field sorts ascending. To sort a field descending, prefix it with -. Ties are sorted by id.
status
enum<string>
Returns only turns with this status.
Available options:
queued,
running,
waiting,
completed,
failed,
cancelled
Response
One page of turns.
results
object[]
required
The results in this page.
Show child attributes
has_more
boolean
required
True if more results follow this page; false otherwise.
next_cursor
string | null
required
Where the next page starts: to get it, list again with this value as cursor. A cursor from the last page later finds results added after it. Null if the list is empty.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Judt","description":"Give your agent the ability to build and publish powerful, realtime, dynamic Apps and Websites.","colors":{"primary":"#E43636","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db","dark":"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db","href":"https://judt.ai"},"favicon":{"light":"https://mintcdn.com/judt/2s5Qii8OX7bN-fZp/images/red-01.svg?fit=max\u0026auto=format\u0026n=2s5Qii8OX7bN-fZp\u0026q=85\u0026s=9ceea1c72bdeebc33354323ff61e7a82","dark":"https://mintcdn.com/judt/2s5Qii8OX7bN-fZp/images/red-01.svg?fit=max\u0026auto=format\u0026n=2s5Qii8OX7bN-fZp\u0026q=85\u0026s=9ceea1c72bdeebc33354323ff61e7a82"},"appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Go to Dashboard","href":"https://judt.ai/apps"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"General Sans","weight":700},"body":{"family":"switzer","weight":400}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"judt","hasAudioNarration":false,"actualSubdomain":"judt","customDomains":["docs.judt.ai"],"gitSource":{"type":"github","owner":"judt-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af260d84450952f7c00a1c4","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":45},{"language":"default","tag":"Build Apps","count":19},{"language":"default","tag":"Manage Apps","count":15},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Get started","count":7},{"language":"default","tag":"Apps","count":7},{"language":"default","tag":"Sandbox","count":7},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Project","count":4},{"language":"default","tag":"Storage","count":4}]},"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":"custom-rbac-roles","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url(\"https://api.fontshare.com/v2/css?f[]=general-sans@700\u0026f[]=switzer@400\u0026display=swap\");:root{--font-heading: \"General Sans\", sans-serif;--font-body: \"Switzer\", sans-serif}body{font-family:var(--font-body)!important;font-weight:400}*,*::before,*::after{border-radius:0!important}h1,h2,h3,h4,h5,h6{font-family:var(--font-heading)!important;font-weight:700}"}],"page":{"pagePath":"api-reference/agents/list-turns","slug":"/api-reference/agents/list-turns","pageMetadata":{"title":"List turns","description":"Lists the session's turns, oldest first.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/list-turns","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Lists the session’s turns, oldest first.\"\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":"List turns","description":"Lists the session's turns, oldest first.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/list-turns","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List turns","description":"Lists the session's turns, oldest first.","tags":["Agents"],"operationId":"list_turns","security":["bd55816b-c805-415f-87cc-3a733e793130"],"parameters":["2e56b684-0cf5-4c95-8531-f8f15151214d","0b778d02-b388-4fbd-ab1a-adf51dd597cf","fbc11418-2c42-40cb-8e51-7200e0eb5362","b2ab6727-229c-4fd8-b093-c3c759979299","094f2828-8e41-43ca-9b2a-9b9056b7ad99","14811e79-5343-438d-a9f9-1b7186ce7168"],"responses":{"200":"a252d8d8-f814-434c-a73f-a21e7c50229b","400":"635d500a-9444-493e-94ac-e41abe2fc6ab","401":"8410b990-f6a8-4225-bb1e-ed5ff48d090e","403":"828810c6-3441-4d4c-9551-3dd2ef56cdfe","404":"79dfcc08-e3e7-4010-b3e1-49a22c9c20ec","410":"de768012-fc0e-4ede-99fa-9b2dac45ca38"},"method":"get","type":"path","servers":["b2c0c780-a427-4ff6-96e6-3611f64a9207"],"path":"/api/apps/{id}/sessions/{session_id}/turns","baseUrlOptions":["https://api.judt.ai"],"title":"List turns","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2e56b684-0cf5-4c95-8531-f8f15151214d":{"name":"id","in":"path","required":true,"description":"A unique ID that starts with `app_`.","schema":{"type":"string","pattern":"^app_[0-9A-Za-z]{24}$","example":"app_Zj7XhMgplmTJcp5Dk4vcYuk0","isRequired":true,"description":"A unique ID that starts with `app_`.","uniqueKey":"","typeLabel":"string"}},"0b778d02-b388-4fbd-ab1a-adf51dd597cf":{"name":"session_id","in":"path","required":true,"description":"A unique ID that starts with `ses_`.","schema":{"type":"string","pattern":"^ses_[0-9A-Za-z]{24}$","example":"ses_Zj7XhMgplmTJcp5Dk4vcYuk0","isRequired":true,"description":"A unique ID that starts with `ses_`.","uniqueKey":"","typeLabel":"string"}},"fbc11418-2c42-40cb-8e51-7200e0eb5362":{"name":"limit","in":"query","description":"The maximum number of turns to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"The maximum number of turns to return.","uniqueKey":"","typeLabel":"integer"}},"b2ab6727-229c-4fd8-b093-c3c759979299":{"name":"cursor","in":"query","description":"Where to start: the `next_cursor` of the page before, listed with the same `sort`. Without it, the list starts with the first turns.","schema":{"type":"string","minLength":1,"maxLength":4096,"description":"Where to start: the `next_cursor` of the page before, listed with the same `sort`. Without it, the list starts with the first turns.","uniqueKey":"","typeLabel":"string"}},"094f2828-8e41-43ca-9b2a-9b9056b7ad99":{"name":"sort","in":"query","description":"A comma-separated list of fields to sort by: `created_at`. Each field sorts ascending. To sort a field descending, prefix it with `-`. Ties are sorted by `id`.","schema":{"type":"string","default":"created_at","description":"A comma-separated list of fields to sort by: `created_at`. Each field sorts ascending. To sort a field descending, prefix it with `-`. Ties are sorted by `id`.","uniqueKey":"","typeLabel":"string"}},"14811e79-5343-438d-a9f9-1b7186ce7168":{"name":"status","in":"query","description":"Returns only turns with this status.","schema":{"type":"string","enum":["queued","running","waiting","completed","failed","cancelled"],"description":"Returns only turns with this status.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"a252d8d8-f814-434c-a73f-a21e7c50229b":{"description":"One page of turns.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The turn's ID, which starts with `trn_`.","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string"},"session_id":{"type":"string","description":"The ID of the session that the turn belongs to.","isRequired":true,"uniqueKey":"results.items.[INDEX].session_id","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","waiting","completed","failed","cancelled"],"description":"The turn's state:\n- `queued`: waiting behind the session's active turn.\n- `running`: the agent is working.\n- `waiting`: the agent needs input from a person, which `input_request` describes.\n- `completed`, `failed`, or `cancelled`: the turn has ended, and its status doesn't change again.","isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"The message that started the turn.","isRequired":true,"uniqueKey":"results.items.[INDEX].message","typeLabel":"string"},"model":{"type":"string","description":"The model that the turn runs on. If `requested_model` is `auto`, this is the model that Auto chose.","isRequired":true,"uniqueKey":"results.items.[INDEX].model","typeLabel":"string"},"requested_model":{"type":"string","description":"The model that the turn asked for: `auto` or a model ID.","isRequired":true,"uniqueKey":"results.items.[INDEX].requested_model","typeLabel":"string"},"effort":{"type":"string","enum":["low","medium","high","xhigh","max"],"description":"How much the model thinks on this turn, from `low` to `max`. Auto chooses it by how much reasoning the task needs, unless the request set `effort`; with a chosen model, it is the model's default unless the request set it.","isRequired":true,"uniqueKey":"results.items.[INDEX].effort","typeLabel":"enum\u003cstring>"},"input_request":{"oneOf":[{"type":"object","description":"The input that the agent is waiting for, or null if the turn isn't waiting.","required":["id","kind","secrets","reason","expires_at"],"properties":{"id":{"type":"string","description":"The input request's ID.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.id","typeLabel":"string"},"kind":{"type":"string","const":"secrets","description":"The kind of input that the agent needs.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.kind","typeLabel":"string"},"secrets":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The Secret's name.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.secrets.items.[INDEX].name","typeLabel":"string"},"provided":{"type":"boolean","description":"True if the Secret is set; false otherwise.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.secrets.items.[INDEX].provided","typeLabel":"boolean"}},"required":["name","provided"],"additionalProperties":false,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.secrets.items.[INDEX]","typeLabel":"object"},"description":"The Secrets that the agent needs. To provide one, set it with `PUT /api/apps/{id}/secrets/{name}`. The turn resumes after all of them are set. The agent never receives their values.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.secrets","typeLabel":"object[]"},"reason":{"type":"string","description":"Why the agent needs the input, in the agent's words.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.reason","typeLabel":"string"},"expires_at":{"type":"string","format":"date-time","description":"When the request expires. If no one provides or declines the input by then, the turn fails with `input_expired`.","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0.expires_at","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.0","typeLabel":"object"},{"type":"null","description":"The input that the agent is waiting for, or null if the turn isn't waiting.","isRequired":true,"uniqueKey":"results.items.[INDEX].input_request.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].input_request","typeLabel":"object | null"},"base_commit_id":{"oneOf":[{"description":"The commit that the turn started from. To undo the turn, pass this ID as `commit_id` to `POST /api/apps/{id}/restore`.","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].base_commit_id.oneOf.0","typeLabel":"string"},{"description":"The commit that the turn started from. To undo the turn, pass this ID as `commit_id` to `POST /api/apps/{id}/restore`.","type":"null","isRequired":true,"uniqueKey":"results.items.[INDEX].base_commit_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].base_commit_id","typeLabel":"string | null"},"error":{"oneOf":[{"type":"object","description":"Why the turn failed, or null if it didn't fail. The code is one of the following:\n- `agent_error`: the agent stopped unexpectedly.\n- `app_deleted`: the App was deleted.\n- `input_expired`: no one answered the input request in time.\n- `interrupted`: the turn was interrupted repeatedly without progress.\n- `turn_budget_exceeded`: the turn ran out of time.\n- `user_deleted`: the user the turn acts for deleted their account.","required":["code","message"],"properties":{"code":{"type":"string","description":"A stable code for the error.","isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.0.message","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.0","typeLabel":"object"},{"type":"null","description":"Why the turn failed, or null if it didn't fail. The code is one of the following:\n- `agent_error`: the agent stopped unexpectedly.\n- `app_deleted`: the App was deleted.\n- `input_expired`: no one answered the input request in time.\n- `interrupted`: the turn was interrupted repeatedly without progress.\n- `turn_budget_exceeded`: the turn ran out of time.\n- `user_deleted`: the user the turn acts for deleted their account.","isRequired":true,"uniqueKey":"results.items.[INDEX].error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].error","typeLabel":"object | null"},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer","minimum":0,"description":"The number of tokens the model read.","example":12840,"isRequired":true,"uniqueKey":"results.items.[INDEX].usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","minimum":0,"description":"The number of tokens the model wrote.","example":1260,"isRequired":true,"uniqueKey":"results.items.[INDEX].usage.output_tokens","typeLabel":"integer"},"cache_read_tokens":{"type":"integer","minimum":0,"description":"The number of input tokens read from the prompt cache.","example":9600,"isRequired":true,"uniqueKey":"results.items.[INDEX].usage.cache_read_tokens","typeLabel":"integer"}},"required":["input_tokens","output_tokens","cache_read_tokens"],"additionalProperties":false,"description":"The tokens that the turn used.","isRequired":true,"uniqueKey":"results.items.[INDEX].usage","typeLabel":"object"},"created_by":{"oneOf":[{"description":"The ID of the user the turn acts for, or null if that user deleted their account. The turn has that user's current role.","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].created_by.oneOf.0","typeLabel":"string"},{"description":"The ID of the user the turn acts for, or null if that user deleted their account. The turn has that user's current role.","type":"null","isRequired":true,"uniqueKey":"results.items.[INDEX].created_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].created_by","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","description":"When the turn was created.","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"results.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","description":"When the turn started running, or null if it hasn't started.","format":"date-time","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"results.items.[INDEX].started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"When the turn started running, or null if it hasn't started.","isRequired":true,"uniqueKey":"results.items.[INDEX].started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].started_at","typeLabel":"string\u003cdate-time> | null"},"ended_at":{"oneOf":[{"type":"string","description":"When the turn ended, or null if it hasn't ended.","format":"date-time","example":"2026-10-03T14:01:30.000Z","isRequired":true,"uniqueKey":"results.items.[INDEX].ended_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"When the turn ended, or null if it hasn't ended.","isRequired":true,"uniqueKey":"results.items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].ended_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","session_id","status","message","model","requested_model","effort","input_request","base_commit_id","error","usage","created_by","created_at","started_at","ended_at"],"additionalProperties":false,"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"description":"The results in this page.","isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"has_more":{"type":"boolean","description":"True if more results follow this page; false otherwise.","isRequired":true,"uniqueKey":"has_more","typeLabel":"boolean"},"next_cursor":{"oneOf":[{"description":"Where the next page starts: to get it, list again with this value as `cursor`. A cursor from the last page later finds results added after it. Null if the list is empty.","type":"string","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"description":"Where the next page starts: to get it, list again with this value as `cursor`. A cursor from the last page later finds results added after it. Null if the list is empty.","type":"null","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"}},"required":["results","has_more","next_cursor"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"id":"\u003cstring>","session_id":"\u003cstring>","status":"queued","message":"\u003cstring>","model":"\u003cstring>","requested_model":"\u003cstring>","effort":"low","input_request":{"id":"\u003cstring>","kind":"secrets","secrets":[{"name":"\u003cstring>","provided":true}],"reason":"\u003cstring>","expires_at":"2026-10-03T14:01:30.000Z"},"base_commit_id":"\u003cstring>","error":{"code":"\u003cstring>","message":"\u003cstring>"},"usage":{"input_tokens":12840,"output_tokens":1260,"cache_read_tokens":9600},"created_by":"\u003cstring>","created_at":"2026-10-03T14:01:30.000Z","started_at":"2026-10-03T14:01:30.000Z","ended_at":"2026-10-03T14:01:30.000Z"}],"has_more":true,"next_cursor":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"635d500a-9444-493e-94ac-e41abe2fc6ab":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8410b990-f6a8-4225-bb1e-ed5ff48d090e":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"828810c6-3441-4d4c-9551-3dd2ef56cdfe":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"79dfcc08-e3e7-4010-b3e1-49a22c9c20ec":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"de768012-fc0e-4ede-99fa-9b2dac45ca38":{"description":"An error, with its code and the request ID.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","description":"A stable code for the error, such as `not_found`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A readable explanation of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"The request's ID. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"detail":{"type":"string","description":"More information, if any: the sandbox's error, a provider message, or, for a `504`, how far the work got and the ID of its latest event.","uniqueKey":"error.detail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","detail":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bd55816b-c805-415f-87cc-3a733e793130":{"ApiToken":{"type":"http","scheme":"bearer","description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","scopes":[],"schemeName":"ApiToken"}}},"servers":{"b2c0c780-a427-4ff6-96e6-3611f64a9207":{"url":"https://api.judt.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","scopes":[],"schemeName":"ApiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with `POST /api/tokens`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiToken","name":"Authorization"}],"title":"ApiToken"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"judt","siteName":"Judt","title":"List turns - Judt","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T00:10:05.093Z","originalFileLocation":"api-reference/agents/list-turns.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Lists the session\u0026#x27;s turns, oldest first.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Judt\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_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/judt/4xH8o5IVMj62_yiA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List turns - Judt\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists the session\u0026#x27;s turns, oldest first.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Judt\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.judt.ai/api-reference/agents/list-turns\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://judt.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+turns\u0026amp;description=Lists+the+session%27s+turns%2C+oldest+first.\u0026amp;theme=52d45eb14d1a23098b96d158\u0026amp;signature=b622e5110526d38b044e410c6d32e1cb0243759635c7135084b8ac6a3ad8555e\">\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=\"List turns - Judt\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists the session\u0026#x27;s turns, oldest first.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://judt.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=List+turns\u0026amp;description=Lists+the+session%27s+turns%2C+oldest+first.\u0026amp;theme=52d45eb14d1a23098b96d158\u0026amp;signature=b622e5110526d38b044e410c6d32e1cb0243759635c7135084b8ac6a3ad8555e\">\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/judt/4xH8o5IVMj62_yiA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Judt\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E43636\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.judt.ai/api-reference/agents/list-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/agents/list-turns.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.judt.ai/#organization\",\"name\":\"Judt\",\"url\":\"https://docs.judt.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/judt/fLHZClc2FLrKxJ_W/images/judt-logo.svg?fit=max\u0026auto=format\u0026n=fLHZClc2FLrKxJ_W\u0026q=85\u0026s=74bb26a7428d0124254a5edb052208db\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.judt.ai#website\",\"name\":\"Judt\",\"url\":\"https://docs.judt.ai\",\"publisher\":{\"@id\":\"https://docs.judt.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.judt.ai/api-reference/agents/list-turns#webpage\",\"url\":\"https://docs.judt.ai/api-reference/agents/list-turns\",\"name\":\"List turns\",\"description\":\"Lists the session's turns, oldest first.\",\"dateModified\":\"2026-11-10T00:10:05.093Z\",\"isPartOf\":{\"@id\":\"https://docs.judt.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.judt.ai/api-reference/agents/list-turns#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.judt.ai/api-reference/agents/list-turns#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.judt.ai/api-reference/agents/list-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List turns\",\"item\":\"https://docs.judt.ai/api-reference/agents/list-turns\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.judt.ai/api-reference/agents/list-turns#apireference\",\"headline\":\"List turns\",\"name\":\"List turns\",\"description\":\"Lists the session's turns, oldest first.\",\"url\":\"https://docs.judt.ai/api-reference/agents/list-turns\",\"mainEntityOfPage\":{\"@id\":\"https://docs.judt.ai/api-reference/agents/list-turns#webpage\"},\"dateModified\":\"2026-11-10T00:10:05.093Z\",\"publisher\":{\"@id\":\"https://docs.judt.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.judt.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Judt\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Judt\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agents/list-turns.md","siteName":"Judt","nav":{"global":null,"tabs":[{"tab":"Manage Apps","pages":[{"title":"Manage Apps","href":"/manage/introduction"}]},{"tab":"Build Apps","pages":[{"title":"Build Apps","href":"/build/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Account","pages":[{"title":"Get the caller","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/me","href":"/api-reference/account/get-the-caller"}]},{"group":"Apps","pages":[{"title":"Create an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps","href":"/api-reference/apps/create-an-app"},{"title":"List Apps","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps","href":"/api-reference/apps/list-apps"},{"title":"Get an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}","href":"/api-reference/apps/get-an-app"},{"title":"Update an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/apps/{id}","href":"/api-reference/apps/update-an-app"},{"title":"Delete an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}","href":"/api-reference/apps/delete-an-app"},{"title":"Create a visitor token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/visitor-tokens","href":"/api-reference/apps/create-a-visitor-token"},{"title":"Create a deep link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/deep-links","href":"/api-reference/apps/create-a-deep-link"}]},{"group":"Tokens","pages":[{"title":"Create an App token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/tokens","href":"/api-reference/tokens/create-an-app-token"}]},{"group":"Secrets","pages":[{"title":"List Secrets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets","href":"/api-reference/secrets/list-secrets"},{"title":"Get a Secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/get-a-secret"},{"title":"Set a Secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/set-a-secret"},{"title":"Delete a Secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/secrets/{name}","href":"/api-reference/secrets/delete-a-secret"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/files","href":"/api-reference/files/list-files"},{"title":"Read a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/files/{path}","href":"/api-reference/files/read-a-file"},{"title":"Write a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/apps/{id}/files/{path}","href":"/api-reference/files/write-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/files/{path}","href":"/api-reference/files/delete-a-file"}]},{"group":"Sandbox","pages":[{"title":"Run a command","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/commands","href":"/api-reference/sandbox/run-a-command"},{"title":"Get Git information","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/git","href":"/api-reference/sandbox/get-git-information"},{"title":"Create a commit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/commits","href":"/api-reference/sandbox/create-a-commit"},{"title":"List commits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/commits","href":"/api-reference/sandbox/list-commits"},{"title":"Restore a commit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/restore","href":"/api-reference/sandbox/restore-a-commit"},{"title":"Create a preview link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/preview","href":"/api-reference/sandbox/create-a-preview-link"},{"title":"Stop the sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/stop","href":"/api-reference/sandbox/stop-the-sandbox"}]},{"group":"Deployments","pages":[{"title":"Deploy the App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/deployments","href":"/api-reference/deployments/deploy-the-app"},{"title":"List deployments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/deployments","href":"/api-reference/deployments/list-deployments"},{"title":"Get a deployment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/deployments/{deployment_id}","href":"/api-reference/deployments/get-a-deployment"},{"title":"Unpublish an App","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/unpublish","href":"/api-reference/deployments/unpublish-an-app"}]},{"group":"Monitoring","pages":[{"title":"List App events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/events","href":"/api-reference/monitoring/list-app-events"},{"title":"List logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/logs","href":"/api-reference/monitoring/list-logs"}]},{"group":"Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/templates","href":"/api-reference/templates/list-templates"}]},{"group":"Agents","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/models","href":"/api-reference/agents/list-models"},{"title":"Create a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions","href":"/api-reference/agents/create-a-session"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions","href":"/api-reference/agents/list-sessions"},{"title":"Get a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/get-a-session"},{"title":"Update a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/update-a-session"},{"title":"Delete a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/apps/{id}/sessions/{session_id}","href":"/api-reference/agents/delete-a-session"},{"title":"Send a message","description":"Starts a turn with your message. If the session already has an active turn, the new turn waits in a queue behind it. The queue holds up to five turns, and they run in the order that you sent them.\n\nThe response returns when the turn starts or joins the queue, not when it finishes. To follow the turn, stream the session's events or get the turn.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/send-a-message"},{"title":"List turns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns","href":"/api-reference/agents/list-turns"},{"title":"Get a turn","description":"Returns the turn's status, any pending input request, its outcome, and its token usage.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/turns/{turn_id}","href":"/api-reference/agents/get-a-turn"},{"title":"Cancel a turn","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns/{turn_id}/cancel","href":"/api-reference/agents/cancel-a-turn"},{"title":"Decline an input request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/apps/{id}/sessions/{session_id}/turns/{turn_id}/decline","href":"/api-reference/agents/decline-an-input-request"},{"title":"List session events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/apps/{id}/sessions/{session_id}/events","href":"/api-reference/agents/list-session-events"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/feedback","href":"/api-reference/feedback/send-feedback"}]}]}]},"basePath":"","title":"List turns - Judt","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}