Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.
True when an admin is inspecting another user’s session. Follow-ups and deletion remain owner-scoped.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"video2ctx","description":"Turn videos into useful context for people, applications, and AI agents.","colors":{"primary":"#c83b30","light":"#f45d4f","dark":"#c83b30"},"logo":{"light":"https://mintcdn.com/video2ctx/oVItuJlvJaZVlvdk/logo/light.svg?fit=max\u0026auto=format\u0026n=oVItuJlvJaZVlvdk\u0026q=85\u0026s=67e12859318ddbe8253aaa9606e03c4c","dark":"https://mintcdn.com/video2ctx/oVItuJlvJaZVlvdk/logo/dark.svg?fit=max\u0026auto=format\u0026n=oVItuJlvJaZVlvdk\u0026q=85\u0026s=4cb973a13fcd2a06fc4153af330f720b"},"favicon":"https://mintcdn.com/video2ctx/oVItuJlvJaZVlvdk/favicon.png?fit=max\u0026auto=format\u0026n=oVItuJlvJaZVlvdk\u0026q=85\u0026s=e7f7ea7c681665abbcbc0edb39aa5c14","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["bash","javascript","python"],"prefill":true,"autogenerate":true}},"navbar":{"links":[{"href":"/api-reference/introduction","label":"API reference"},{"href":"mailto:support@video2ctx.dev","label":"Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://video2ctx.dev/dashboard"}},"footer":{"socials":{"github":"https://github.com/devhims/video2ctx"}},"seo":{"metatags":{"canonical":"https://docs.video2ctx.dev"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/devhims/video2ctx"},{"anchor":"API status","icon":"signal-stream","href":"https://api.video2ctx.dev/health"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"video2ctx","hasAudioNarration":false,"actualSubdomain":"video2ctx","customDomains":["docs.video2ctx.dev"],"gitSource":{"type":"github","owner":"devhims","repo":"video2ctx","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeffb1c69e61846fb391692","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API reference","count":51},{"language":"default","tag":"Endpoints","count":50},{"language":"default","tag":"Agents","count":12},{"language":"default","tag":"Build with API","count":10},{"language":"default","tag":"Dashboard","count":8},{"language":"default","tag":"Monitoring","count":8},{"language":"default","tag":"Projects","count":5},{"language":"default","tag":"Videos","count":5},{"language":"default","tag":"Build with Agents","count":4},{"language":"default","tag":"Open source","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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agents/read-an-agent-session","slug":"/api-reference/agents/read-an-agent-session","pageMetadata":{"title":"Read an agent session","description":"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions/{sessionId}","href":"/api-reference/agents/read-an-agent-session","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: \"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\"\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":"Read an agent session","description":"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions/{sessionId}","href":"/api-reference/agents/read-an-agent-session","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"operationId":"getAgentSession","summary":"Read an agent session","description":"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.","security":["9f77fd0a-4c02-475d-8ca8-181a777f6c0d","716b735f-8563-4b3d-830b-13190caa6d9c","b7f93d23-1363-4d11-b645-61bc3932da5c","d459157a-9cb0-404a-ac19-81df0f6e9b4b","939a1d5a-59ac-4cc6-baab-64f9108b2b19"],"parameters":["4432abf5-650d-4c30-b2c4-336a250f3968","e7587b26-bc7d-4f1e-9893-842e8e6edeaf","1166c9f9-66a3-4bcc-a067-30d660f34145"],"responses":{"200":"0e5a9642-cd96-4177-9211-11a80d17cc49","401":"552a5439-d75e-4f74-bee2-ad40d8c93f76","403":"0397722c-8923-402b-a49b-e063de22eb24","404":"2a059509-cb7b-4987-b2f7-2b82db4be44d","422":"e8dfd109-aa93-4089-b86d-1086863c8a4a","500":"5df162ed-61a4-409f-be70-99be7581818b","503":"a663bd31-d800-4ca3-892f-f85d4f47f28b"},"x-video2ctx-audience":"consumer","method":"get","type":"path","servers":["0fd987e0-981d-4cca-ac1b-c4a44c4acb58"],"path":"/v1/agent/sessions/{sessionId}","baseUrlOptions":["https://api.video2ctx.dev"],"title":"Read an agent session","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"4432abf5-650d-4c30-b2c4-336a250f3968":{"name":"sessionId","in":"path","required":true,"description":"Session UUID returned by agent admission.","schema":{"type":"string","minLength":1,"isRequired":true,"description":"Session UUID returned by agent admission.","uniqueKey":"","typeLabel":"string"}},"e7587b26-bc7d-4f1e-9893-842e8e6edeaf":{"name":"limit","in":"query","required":false,"description":"Maximum turns to return. Each turn produces one user message and one assistant message.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"isRequired":false,"description":"Maximum turns to return. Each turn produces one user message and one assistant message.","uniqueKey":"","typeLabel":"integer"}},"1166c9f9-66a3-4bcc-a067-30d660f34145":{"name":"cursor","in":"query","required":false,"description":"Opaque cursor for loading turns older than the current page.","schema":{"type":"string","maxLength":500,"isRequired":false,"description":"Opaque cursor for loading turns older than the current page.","uniqueKey":"","typeLabel":"string"}}},"responses":{"0e5a9642-cd96-4177-9211-11a80d17cc49":{"description":"The restored agent session.","content":{"application/json":{"schema":{"type":"object","required":["messages","nextCursor","sessionId","title","latestMessagePreview","lastRunId","runCount","createdAt","updatedAt"],"properties":{"sessionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"sessionId","typeLabel":"string\u003cuuid>"},"title":{"type":"string","maxLength":80,"isRequired":true,"uniqueKey":"title","typeLabel":"string"},"latestMessagePreview":{"type":"string","maxLength":240,"isRequired":true,"uniqueKey":"latestMessagePreview","typeLabel":"string"},"lastRunId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"lastRunId","typeLabel":"string\u003cuuid>"},"runCount":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"runCount","typeLabel":"integer"},"createdAt":{"type":"integer","minimum":0,"description":"Unix timestamp in milliseconds.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"integer"},"updatedAt":{"type":"integer","minimum":0,"description":"Unix timestamp in milliseconds.","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"integer"},"messages":{"type":"array","maxItems":200,"items":{"type":"object","required":["messageId","runId","conversationTurn","parentMessageId","role","status","content","createdAt","updatedAt"],"properties":{"messageId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"messages.items.[INDEX].messageId","typeLabel":"string\u003cuuid>"},"runId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"messages.items.[INDEX].runId","typeLabel":"string\u003cuuid>"},"conversationTurn":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"messages.items.[INDEX].conversationTurn","typeLabel":"integer"},"parentMessageId":{"oneOf":[{"type":"string","format":"uuid","description":"The preceding message in this conversation branch.","isRequired":true,"uniqueKey":"messages.items.[INDEX].parentMessageId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The preceding message in this conversation branch.","isRequired":true,"uniqueKey":"messages.items.[INDEX].parentMessageId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"messages.items.[INDEX].parentMessageId","typeLabel":"string\u003cuuid> | null"},"role":{"type":"string","enum":["user","assistant"],"isRequired":true,"uniqueKey":"messages.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled"],"isRequired":true,"uniqueKey":"messages.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"content":{"type":"string","description":"Empty for an assistant message whose run has not produced an answer.","isRequired":true,"uniqueKey":"messages.items.[INDEX].content","typeLabel":"string"},"createdAt":{"type":"integer","minimum":0,"description":"Unix timestamp in milliseconds.","isRequired":true,"uniqueKey":"messages.items.[INDEX].createdAt","typeLabel":"integer"},"updatedAt":{"type":"integer","minimum":0,"description":"Unix timestamp in milliseconds.","isRequired":true,"uniqueKey":"messages.items.[INDEX].updatedAt","typeLabel":"integer"}},"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"},"nextCursor":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nextCursor.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nextCursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nextCursor","typeLabel":"string | null"},"readOnly":{"type":"boolean","description":"True when an admin is inspecting another user’s session. Follow-ups and deletion remain owner-scoped.","uniqueKey":"readOnly","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sessionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","latestMessagePreview":"\u003cstring>","lastRunId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","runCount":2,"createdAt":1,"updatedAt":1,"messages":[{"messageId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","runId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","conversationTurn":2,"parentMessageId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","role":"user","status":"pending","content":"\u003cstring>","createdAt":1,"updatedAt":1}],"nextCursor":"\u003cstring>","readOnly":true}}},"exampleType":"generated"}},"exampleType":"generated"},"552a5439-d75e-4f74-bee2-ad40d8c93f76":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0397722c-8923-402b-a49b-e063de22eb24":{"description":"The caller is not allowed to perform this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2a059509-cb7b-4987-b2f7-2b82db4be44d":{"description":"The requested resource was not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e8dfd109-aa93-4089-b86d-1086863c8a4a":{"description":"The request failed validation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5df162ed-61a4-409f-be70-99be7581818b":{"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a663bd31-d800-4ca3-892f-f85d4f47f28b":{"description":"An upstream AI or YouTube service is unavailable.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"QUERY_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"QUERY_REQUIRED","message":"\u003cstring>","details":"\u003cunknown>","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9f77fd0a-4c02-475d-8ca8-181a777f6c0d":{"bearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Permanent personal API key created in the dashboard. Example: curl -H \"Authorization: Bearer aty_…\" https://your-host/v1/projects","scopes":[],"schemeName":"bearerApiKey"}},"716b735f-8563-4b3d-830b-13190caa6d9c":{"sessionCookie":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"Better Auth session cookie. A production deployment may use the secure-prefixed cookie name; same-origin browser requests send it automatically.","scopes":[],"schemeName":"sessionCookie"}},"b7f93d23-1363-4d11-b645-61bc3932da5c":{"cliSession":{"type":"http","scheme":"bearer","bearerFormat":"CLI session","description":"Short-lived, revocable session issued by the video2ctx device authorization flow. The official CLI stores and sends this value; never paste it into prompts or logs.","scopes":[],"schemeName":"cliSession"}},"d459157a-9cb0-404a-ac19-81df0f6e9b4b":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Legacy-compatible header for a permanent personal API key. Prefer Authorization: Bearer aty_….","scopes":[],"schemeName":"apiKey"}},"939a1d5a-59ac-4cc6-baab-64f9108b2b19":{"demoUser":{"type":"apiKey","in":"header","name":"X-Demo-User","description":"Local development only. Any stable value selects an isolated demo account. Rejected in production.","scopes":[],"schemeName":"demoUser"}}},"servers":{"0fd987e0-981d-4cca-ac1b-c4a44c4acb58":{"url":"https://api.video2ctx.dev","description":"Hosted video2ctx API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Permanent personal API key created in the dashboard. Example: curl -H \"Authorization: Bearer aty_…\" https://your-host/v1/projects","scopes":[],"schemeName":"bearerApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Permanent personal API key created in the dashboard. Example: curl -H \"Authorization: Bearer aty_…\" https://your-host/v1/projects","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerApiKey","name":"Authorization"}],"title":"bearerApiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"cookie","name":"better-auth.session_token","description":"Better Auth session cookie. A production deployment may use the secure-prefixed cookie name; same-origin browser requests send it automatically.","scopes":[],"schemeName":"sessionCookie"},"schema":{"title":"better-auth.session_token","type":"string","description":"Better Auth session cookie. A production deployment may use the secure-prefixed cookie name; same-origin browser requests send it automatically.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"sessionCookie","name":"better-auth.session_token"}],"title":"sessionCookie"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"CLI session","description":"Short-lived, revocable session issued by the video2ctx device authorization flow. The official CLI stores and sends this value; never paste it into prompts or logs.","scopes":[],"schemeName":"cliSession"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Short-lived, revocable session issued by the video2ctx device authorization flow. The official CLI stores and sends this value; never paste it into prompts or logs.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"cliSession","name":"Authorization"}],"title":"cliSession"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Legacy-compatible header for a permanent personal API key. Prefer Authorization: Bearer aty_….","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-API-Key","type":"string","description":"Legacy-compatible header for a permanent personal API key. Prefer Authorization: Bearer aty_….","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Demo-User","description":"Local development only. Any stable value selects an isolated demo account. Rejected in production.","scopes":[],"schemeName":"demoUser"},"schema":{"title":"X-Demo-User","type":"string","description":"Local development only. Any stable value selects an isolated demo account. Rejected in production.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"demoUser","name":"X-Demo-User"}],"title":"demoUser"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"video2ctx","siteName":"video2ctx","title":"Read an agent session - video2ctx","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T07:17:38.700Z","originalFileLocation":"api-reference/agents/read-an-agent-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\">\u003cmeta data-mint-head name=\"application-name\" content=\"video2ctx\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_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/video2ctx/AFWBTaEFZxyvXT1o/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read an agent session - video2ctx\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"video2ctx\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://video2ctx.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Read+an+agent+session\u0026amp;description=Returns+the+authenticated+user%E2%80%99s+session+metadata+and+a+chronological+page+of+user+and+assistant+messages.+A+verified+live+admin+browser+session+can+also+read+a\u0026amp;theme=1a90da152731d42ef07b77a2\u0026amp;signature=7667beb19711bcc19cdd09a65f703c2620bd275d9aa4e3b313309894870dd0d9\">\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=\"Read an agent session - video2ctx\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://video2ctx.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Read+an+agent+session\u0026amp;description=Returns+the+authenticated+user%E2%80%99s+session+metadata+and+a+chronological+page+of+user+and+assistant+messages.+A+verified+live+admin+browser+session+can+also+read+a\u0026amp;theme=1a90da152731d42ef07b77a2\u0026amp;signature=7667beb19711bcc19cdd09a65f703c2620bd275d9aa4e3b313309894870dd0d9\">\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/video2ctx/AFWBTaEFZxyvXT1o/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"video2ctx\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c83b30\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/read-an-agent-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.video2ctx.dev/#organization\",\"name\":\"video2ctx\",\"url\":\"https://docs.video2ctx.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/video2ctx/oVItuJlvJaZVlvdk/logo/light.svg?fit=max\u0026auto=format\u0026n=oVItuJlvJaZVlvdk\u0026q=85\u0026s=67e12859318ddbe8253aaa9606e03c4c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.video2ctx.dev#website\",\"name\":\"video2ctx\",\"url\":\"https://docs.video2ctx.dev\",\"publisher\":{\"@id\":\"https://docs.video2ctx.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session#webpage\",\"url\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session\",\"name\":\"Read an agent session\",\"description\":\"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\",\"dateModified\":\"2026-11-07T07:17:38.700Z\",\"isPartOf\":{\"@id\":\"https://docs.video2ctx.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.video2ctx.dev/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoints\",\"item\":\"https://docs.video2ctx.dev/api-reference/system/get-platform-information\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Agents\",\"item\":\"https://docs.video2ctx.dev/api-reference/agents/start-a-durable-agent-run\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Read an agent session\",\"item\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session#apireference\",\"headline\":\"Read an agent session\",\"name\":\"Read an agent session\",\"description\":\"Returns the authenticated user’s session metadata and a chronological page of user and assistant messages. A verified live admin browser session can also read another user’s session for debugging, even without an Agent rollout grant; readOnly is true for that view. API keys and CLI sessions remain owner-scoped. The first page contains the newest turns, ordered oldest to newest within the page. Use nextCursor to load older turns. Tool calls, evidence packets, and internal events are not included.\",\"url\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.video2ctx.dev/api-reference/agents/read-an-agent-session#webpage\"},\"dateModified\":\"2026-11-07T07:17:38.700Z\",\"publisher\":{\"@id\":\"https://docs.video2ctx.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.video2ctx.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"video2ctx\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"video2ctx\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agents/read-an-agent-session.md","siteName":"video2ctx","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/devhims/video2ctx"},{"anchor":"API status","icon":"signal-stream","href":"https://api.video2ctx.dev/health"}]},"pages":[{"group":"Start here","pages":[{"title":"Video context for agents and builders","href":"/index"}]},{"group":"Dashboard","pages":[{"title":"Use the Dashboard","href":"/dashboard"},{"title":"Dashboard quickstart","href":"/dashboard/getting-started"},{"title":"Sources, videos, and playlists","href":"/dashboard/sources"},{"title":"Choose video data","href":"/dashboard/data-options"},{"title":"Projects and saved research","href":"/dashboard/projects"},{"title":"Monitor channels","href":"/dashboard/monitoring"},{"title":"Notifications and email consent","href":"/dashboard/notifications"},{"title":"Account, credits, and API keys","href":"/dashboard/account"}]},{"group":"Build with Agents","pages":[{"title":"Build with Agents","href":"/agents"},{"title":"Install agent skills","href":"/skills/installation"},{"title":"Use YouTube context","href":"/skills/youtube-ctx"},{"title":"Use the hosted platform","href":"/skills/video2ctx-platform"}]},{"group":"Build with API","pages":[{"title":"Build with API","href":"/api"},{"title":"API quickstart","href":"/api/quickstart"},{"title":"Authentication","href":"/api/authentication"},{"title":"API conventions","href":"/api/conventions"},{"title":"Credits","href":"/api/credits"},{"title":"Discovery","href":"/api/discovery"},{"title":"Videos, channels, and playlists","href":"/api/entities"},{"title":"Projects and research","href":"/api/research"},{"title":"Monitoring API","href":"/api/monitoring"},{"title":"Node.js library","href":"/api/node-library"}]},{"group":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"},{"group":"Endpoints","pages":[{"group":"System","pages":[{"title":"Get platform information","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /","href":"/api-reference/system/get-platform-information"},{"title":"Check platform health","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/system/check-platform-health"},{"title":"Get the OpenAPI document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /openapi.json","href":"/api-reference/system/get-the-openapi-document"},{"title":"Open the Scalar API reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /docs","href":"/api-reference/system/open-the-scalar-api-reference"}]},{"group":"Authentication","pages":[{"title":"Start CLI device authorization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/auth/device/code","href":"/api-reference/authentication/start-cli-device-authorization"},{"title":"Poll for an approved CLI session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/auth/device/token","href":"/api-reference/authentication/poll-for-an-approved-cli-session"}]},{"group":"Agents","pages":[{"title":"Start a durable agent run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/agent","href":"/api-reference/agents/start-a-durable-agent-run"},{"title":"Check agent access for the authenticated account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/access","href":"/api-reference/agents/check-agent-access-for-the-authenticated-account"},{"title":"List or search agent sessions","description":"Lists the authenticated user’s conversation sessions by recent activity. The optional query performs lexical full-text search over the user prompts recorded for each session. It does not use embeddings or model memory.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions","href":"/api-reference/agents/list-or-search-agent-sessions"},{"title":"Read an agent session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions/{sessionId}","href":"/api-reference/agents/read-an-agent-session"},{"title":"List session evidence and memory","description":"Returns the authenticated owner’s stored evidence inventory and derived session memory. Live admin browser sessions can read another user’s inventory for debugging. Raw evidence is loaded separately by version. Deletion remains owner-scoped.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions/{sessionId}/assets","href":"/api-reference/agents/list-session-evidence-and-memory"},{"title":"Delete all session evidence and memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/agent/sessions/{sessionId}/assets","href":"/api-reference/agents/delete-all-session-evidence-and-memory"},{"title":"Read a stored session asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/sessions/{sessionId}/assets/{version}","href":"/api-reference/agents/read-a-stored-session-asset"},{"title":"Delete one evidence version and dependent memory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/agent/sessions/{sessionId}/assets/{version}","href":"/api-reference/agents/delete-one-evidence-version-and-dependent-memory"},{"title":"Forget a session memory entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/agent/sessions/{sessionId}/memory/{id}","href":"/api-reference/agents/forget-a-session-memory-entry"},{"title":"Get a durable agent run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/{sessionId}/runs/{runId}","href":"/api-reference/agents/get-a-durable-agent-run"},{"title":"View a saved agent video frame","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/frames/{collectionId}/{assetId}","href":"/api-reference/agents/view-a-saved-agent-video-frame"},{"title":"Watch an agent run and its tool activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/agent/{sessionId}/runs/{runId}/events","href":"/api-reference/agents/watch-an-agent-run-and-its-tool-activity"}]},{"group":"Discovery","pages":[{"title":"Search a project’s indexed evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{projectId}/search","href":"/api-reference/discovery/search-a-project’s-indexed-evidence"},{"title":"Search a video provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/search","href":"/api-reference/discovery/search-a-video-provider"},{"title":"Browse a provider discovery feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/browse","href":"/api-reference/discovery/browse-a-provider-discovery-feed"}]},{"group":"Providers","pages":[{"title":"List supported video providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/providers","href":"/api-reference/providers/list-supported-video-providers"}]},{"group":"Videos","pages":[{"title":"Inspect a video","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/inspect-a-video"},{"title":"List transcript tracks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/{id}/tracks","href":"/api-reference/videos/list-transcript-tracks"},{"title":"Get a timed transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/{id}/transcript","href":"/api-reference/videos/get-a-timed-transcript"},{"title":"Get video comments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/{id}/comments","href":"/api-reference/videos/get-video-comments"},{"title":"Get endscreen elements","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/videos/{id}/endscreen","href":"/api-reference/videos/get-endscreen-elements"}]},{"group":"Channels","pages":[{"title":"Inspect a channel","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/channels/{id}","href":"/api-reference/channels/inspect-a-channel"},{"title":"List channel videos","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/channels/{id}/videos","href":"/api-reference/channels/list-channel-videos"},{"title":"List channel playlists","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/channels/{id}/playlists","href":"/api-reference/channels/list-channel-playlists"}]},{"group":"Playlists","pages":[{"title":"Inspect a playlist","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/playlists/{id}","href":"/api-reference/playlists/inspect-a-playlist"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects","href":"/api-reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects","href":"/api-reference/projects/create-a-project"},{"title":"Get a project and its saved items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/projects/{id}","href":"/api-reference/projects/get-a-project-and-its-saved-items"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/projects/{id}","href":"/api-reference/projects/delete-a-project"},{"title":"Save material to a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{id}/items","href":"/api-reference/projects/save-material-to-a-project"}]},{"group":"Research","pages":[{"title":"Start a durable import job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/imports","href":"/api-reference/research/start-a-durable-import-job"},{"title":"Get import job status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}","href":"/api-reference/research/get-import-job-status"}]},{"group":"Exports","pages":[{"title":"Create a project export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/projects/{id}/exports","href":"/api-reference/exports/create-a-project-export"},{"title":"Download an export","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/exports/{id}/download","href":"/api-reference/exports/download-an-export"}]},{"group":"Monitoring","pages":[{"title":"List monitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/monitors","href":"/api-reference/monitoring/list-monitors"},{"title":"Create a monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/monitors","href":"/api-reference/monitoring/create-a-monitor"},{"title":"Delete a monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/monitors/{id}","href":"/api-reference/monitoring/delete-a-monitor"},{"title":"Update a monitor schedule or display metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/monitors/{id}","href":"/api-reference/monitoring/update-a-monitor-schedule-or-display-metadata"},{"title":"List recent notifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/notifications","href":"/api-reference/monitoring/list-recent-notifications"},{"title":"Mark a notification as read","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/notifications/{id}/read","href":"/api-reference/monitoring/mark-a-notification-as-read"},{"title":"Get notification preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/notification-preferences","href":"/api-reference/monitoring/get-notification-preferences"},{"title":"Update notification preferences","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/notification-preferences","href":"/api-reference/monitoring/update-notification-preferences"}]},{"group":"Billing","pages":[{"title":"Get plan limits and credit balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/usage","href":"/api-reference/billing/get-plan-limits-and-credit-balance"}]},{"group":"Account","pages":[{"title":"Get the authenticated account identity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/account","href":"/api-reference/account/get-the-authenticated-account-identity"}]}]}]},{"group":"Platform internals","pages":[{"title":"Platform internals","href":"/internals/overview"},{"title":"Internal endpoint inventory","href":"/internals/endpoints"}]},{"group":"Open source","pages":[{"title":"Local development","href":"/open-source/local-development"},{"title":"Architecture","href":"/open-source/architecture"},{"title":"Deployment","href":"/open-source/deployment"},{"title":"Contributing","href":"/open-source/contributing"}]}]},"basePath":"","title":"Read an agent session - video2ctx","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}