Creates a session.
A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.
The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.
The language in which the output is generated. For example, if set to EN, the output will be in English. If not specified, the default setting AUTO will be used, which allows Powerdrill Enterprise to automatically detect the appropriate language for the output based on your question. Possible values are:
AUTO: Powerdrill automatically detects your intent and selects the appropriate job mode from data analysis and information retrieval.
DATA_ANALYTICS: Powerdrill focuses specifically on data analysis.
If not specified, the default setting AUTO will be used. However, if your intent is clearly data analysis, we recommend specifying the value as DATA_ANALYSIS. This helps Powerdrill skip the intention detection step, enabling faster question processing.
The maximum number of recent jobs retained as context for the next job, with a value range of 0 to 10. The default value is 10. If set to 0, jobs will be run without any context from previous jobs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Powerdrill","colors":{"primary":"#803FE2","light":"#9E6CE8","dark":"#803FE2"},"logo":{"light":"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/light_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=dc2f74f20167a362fea696e338f33414","dark":"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/dark_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=695f412bda840aa700144b31bb1ec4bb"},"favicon":"https://mintcdn.com/powerdrill-55/bBGveC8zr4vD5DAR/favicon.png?fit=max\u0026auto=format\u0026n=bBGveC8zr4vD5DAR\u0026q=85\u0026s=6f84811bf7e1eefae3b7cca21207dc09","background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/powerdrill-55/background.png"},"navbar":{"links":[{"href":"https://github.com/powerdrillai","label":"GitHub"}],"primary":{"type":"button","label":"Get Started","href":"https://powerdrill.ai"}},"footer":{"socials":{"github":"https://github.com/powerdrillai","youtube":"https://www.youtube.com/@powerdrill_ai","twitter":"https://twitter.com/powerdrillai","discord":"https://discord.gg/ZsyyD5ysRC","linkedin":"https://www.linkedin.com/company/powerdrill"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"powerdrill-55","hasAudioNarration":false,"actualSubdomain":"powerdrill-55","customDomains":["docs.powerdrill.ai"],"gitSource":{"type":"github","owner":"powerdrillai","repo":"powerdrill_docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a676e74b2a6a80119146f2c","collectionId":"16d59170-1e02-488c-bffd-27d8bdcf9eb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a676e74b2a6a80119146f2c"},"entitlements":{},"buildId":"6a676e74b2a6a80119146f2c:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":54},{"language":"default","tag":"Open API V2","count":28},{"language":"default","tag":"Open API V1 (Deprecated)","count":26},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Data sources","count":12},{"language":"default","tag":"Datasets","count":12},{"language":"default","tag":"Sessions","count":12},{"language":"default","tag":"Enterprise","count":11},{"language":"default","tag":"Features","count":9},{"language":"default","tag":"Overview","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/create-session","slug":"/api-reference/v2/create-session","pageMetadata":{"openapi":"post /v2/team/sessions","title":"Create session","description":"Creates a session. \nA session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.","href":"/api-reference/v2/create-session"},"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: \"Creates a session.\\nA session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\"\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":{"openapi":"post /v2/team/sessions","title":"Create session","description":"Creates a session. \nA session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.","href":"/api-reference/v2/create-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create session","deprecated":false,"description":"Creates a session. \nA session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.","tags":["Session"],"parameters":["d63eb853-bdbb-40fb-8153-43f2b595e192"],"requestBody":"292cd4ad-a9ee-4e00-ad04-b2bf9a3cb3b2","responses":{"200":"faae4c18-27f2-4f08-ae26-776e76230bf9"},"security":["40130041-a4f8-4faf-b737-0187e66b44bd"],"method":"post","type":"path","servers":["81ddd8d1-e0c9-427d-9d45-c7531fb084ca"],"path":"/v2/team/sessions","baseUrlOptions":["https://ai.data.cloud/api"],"title":"Create session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d63eb853-bdbb-40fb-8153-43f2b595e192":{"name":"x-pd-external-trace-id","in":"header","description":"The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.","required":false,"example":"","schema":{"type":"string","isRequired":false,"description":"The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The session name, which can be up to 128 characters in length. If it exceeds this limit, it will be truncated.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"user_id":{"type":"string","description":"Your user ID, which uniquely identifies you within your team. To obtain your ID:\n\n- If you're the team admin, refer to [Check user information](/enterprise/users#check-user-information).\n- If you're a system or virtual user, ask your team admin to check your user ID by referring to [Check user information](/enterprise/users#check-user-information).","isRequired":true,"uniqueKey":"user_id","typeLabel":"string"},"output_language":{"type":"string","enum":["AUTO","EN","ES","AR","PT","ID","JA","RU","HI","FR","DE","VI","TR","PL","IT","KO","ZH-CN","ZH-TW"],"default":"AUTO","description":"The language in which the output is generated. For example, if set to `EN`, the output will be in English. If not specified, the default setting `AUTO` will be used, which allows Powerdrill Enterprise to automatically detect the appropriate language for the output based on your question. Possible values are:\n- `AUTO`: adaptive recognition\n- `EN`: English\n- `ES`: Spanish\n- `AR`: Arabic\n- `PT`: Portuguese\n- `ID`: Indonesian\n- `JA`: Japanese\n- `RU`: Russian\n- `HI`: Hindi\n- `FR`: French\n- `DE`: German\n- `VI`: Vietnamese\n- `TR`: Turkish\n- `PL`: Polish\n- `IT`: Italian\n- `KO`: Korean\n- `ZH-CN`: Simplified Chinese\n- `ZH-TW`: Traditional Chinese","uniqueKey":"output_language","typeLabel":"enum\u003cstring>"},"job_mode":{"type":"string","description":"Job mode. Possible values are:\n- `AUTO`: Powerdrill automatically detects your intent and selects the appropriate job mode from data analysis and information retrieval.\n- `DATA_ANALYTICS`: Powerdrill focuses specifically on data analysis.\n\nIf not specified, the default setting `AUTO` will be used. However, if your intent is clearly data analysis, we recommend specifying the value as **DATA_ANALYSIS**. This helps Powerdrill skip the intention detection step, enabling faster question processing.","enum":["AUTO","DATA_ANALYTICS"],"default":"DATA_ANALYTICS","uniqueKey":"job_mode","typeLabel":"enum\u003cstring>"},"max_contextual_job_history":{"type":"integer","description":"The maximum number of recent jobs retained as context for the next job, with a value range of `0` to `10`. The default value is `10`. If set to `0`, jobs will be run without any context from previous jobs.","uniqueKey":"max_contextual_job_history","typeLabel":"integer"},"agent_id":{"type":"string","enum":["DATA_ANALYSIS_AGENT"],"default":"DATA_ANALYSIS_AGENT","description":"The ID of the agent. This is a reserved parameter, don't specify it or set it to **DATA_ANALYSIS_AGENT**.","uniqueKey":"agent_id","typeLabel":"enum\u003cstring>"}},"required":["name","user_id"],"uniqueKey":"","typeLabel":"object"},"example":{"name":"My session","output_language":"FR","job_mode":"AUTO","max_contextual_job_history":10,"agent_id":"DATA_ANALYSIS_AGENT","user_id":"tmm-dafasdfasdfasdf"},"examples":{"Example":{"title":"Example","value":{"name":"My session","output_language":"FR","job_mode":"AUTO","max_contextual_job_history":10,"agent_id":"DATA_ANALYSIS_AGENT","user_id":"tmm-dafasdfasdfasdf"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"faae4c18-27f2-4f08-ae26-776e76230bf9":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Status code. **0** indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to [Error Codes](/api-reference/error-codes).","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"data":{"description":"The returned data object.","type":"object","properties":{"id":{"type":"string","description":"The session ID.\n\nSave it if you want to use this session to [run your jobs](/api-reference/v2/create-job) later.","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"}},"required":["id"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data","code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":0,"data":{"id":"session-dasfasdgasdgfasdgasdg"}},"examples":{"Example":{"title":"Example","value":{"code":0,"data":{"id":"session-dasfasdgasdgfasdgasdg"}}}},"exampleType":"examples"}},"headers":{"x-pd-trace-id":{"example":"","required":true,"description":"The trace ID returned by Powerdrill. If a failure occurs, you can provide it to the Powerdrill team to assist with troubleshooting.","schema":{"type":"string"}}},"exampleType":"examples"}},"security":{"40130041-a4f8-4faf-b737-0187e66b44bd":{"apikey-header-x-pd-api-key":{"type":"apiKey","in":"header","name":"x-pd-api-key","scopes":[]}}},"servers":{"81ddd8d1-e0c9-427d-9d45-c7531fb084ca":{"url":"https://ai.data.cloud/api","description":"体验环境"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-pd-api-key","scopes":[]},"schema":{"title":"x-pd-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikey-header-x-pd-api-key","name":"x-pd-api-key"}],"title":"apikey-header-x-pd-api-key"}]},"originalFileLocation":"v2-openapi.json"},"subdomain":"powerdrill-55","siteName":"Powerdrill","title":"Create session - Powerdrill","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-09-18T02:00:46.083Z","originalFileLocation":"api-reference/v2/create-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=\"Creates a session. A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Powerdrill\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create session - Powerdrill\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a session. A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Powerdrill\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.powerdrill.ai/api-reference/v2/create-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://powerdrill-55.mintlify.app/_mintlify/api/og/v2?division=Sessions\u0026amp;title=Create+session\u0026amp;description=Creates+a+session.+%0AA+session+represents+a+continuous+interaction+between+a+user+and+Powerdrill+within+a+single+conversation.+Each+user+can+have+up+to+150+activ\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=e1e86e01f559d1039e358031ab73ac245ed8e719139bb1912a88b9798c53c8cd\">\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=\"Create session - Powerdrill\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a session. A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://powerdrill-55.mintlify.app/_mintlify/api/og/v2?division=Sessions\u0026amp;title=Create+session\u0026amp;description=Creates+a+session.+%0AA+session+represents+a+continuous+interaction+between+a+user+and+Powerdrill+within+a+single+conversation.+Each+user+can+have+up+to+150+activ\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=e1e86e01f559d1039e358031ab73ac245ed8e719139bb1912a88b9798c53c8cd\">\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/powerdrill-55/3_2Bh6rURdJwY8KX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Powerdrill\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#803FE2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.powerdrill.ai/api-reference/v2/create-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/v2/create-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.powerdrill.ai/#organization\",\"name\":\"Powerdrill\",\"url\":\"https://docs.powerdrill.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/powerdrill-55/G5-71rSRmaWb4Deb/logo/light_old.svg?fit=max\u0026auto=format\u0026n=G5-71rSRmaWb4Deb\u0026q=85\u0026s=dc2f74f20167a362fea696e338f33414\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.powerdrill.ai#website\",\"name\":\"Powerdrill\",\"url\":\"https://docs.powerdrill.ai\",\"publisher\":{\"@id\":\"https://docs.powerdrill.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/create-session#webpage\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/create-session\",\"name\":\"Create session\",\"description\":\"Creates a session. A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\",\"dateModified\":\"2025-09-18T02:00:46.083Z\",\"isPartOf\":{\"@id\":\"https://docs.powerdrill.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/create-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/create-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Powerdrill\",\"item\":\"https://docs.powerdrill.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create session\",\"item\":\"https://docs.powerdrill.ai/api-reference/v2/create-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/create-session#apireference\",\"headline\":\"Create session\",\"name\":\"Create session\",\"description\":\"Creates a session. A session represents a continuous interaction between a user and Powerdrill within a single conversation. Each user can have up to 150 active sessions simultaneously. If this limit is reached, you can remove unused sessions to free up space for new ones.\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/create-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/create-session#webpage\"},\"dateModified\":\"2025-09-18T02:00:46.083Z\",\"publisher\":{\"@id\":\"https://docs.powerdrill.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.powerdrill.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Powerdrill\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Powerdrill","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/get-started/introduction"}]},{"tab":"Enterprise","pages":[{"title":"Enterprise","href":"/enterprise/introduction"}]},{"tab":"API Reference","anchors":[{"anchor":"Open API V2","icon":"dice-two","groups":[{"group":"Overview","pages":[{"title":"Overview","icon":"book","href":"/api-reference/v2/overview"},{"title":"Authentication","icon":"key","href":"/api-reference/v2/authentication"},{"title":"Streaming","icon":"grip-lines","href":"/api-reference/v2/streaming"},{"title":"Error Codes","icon":"screwdriver-wrench","href":"/api-reference/error-codes"},{"title":"Create subscriptions","icon":"cart-shopping","href":"/api-reference/v2/create-subscription"}]},{"group":"Developer Guides","pages":[{"title":"Quick Start","icon":"rocket","href":"/developer-guides/quick-start-v2"},{"title":"Check Status of Data Sources","icon":"check","href":"/api-reference/v2/how-to-check-data-sources"}]},{"group":"Datasets","pages":[{"openapi":"post /v2/team/datasets","title":"Create dataset","href":"/api-reference/v2/create-dataset"},{"openapi":"get /v2/team/datasets/{id}/status","mode":"wide","title":"Get status summary of data sources in dataset","href":"/api-reference/v2/get-dataset-status"},{"openapi":"get /v2/team/datasets/{id}/overview","mode":"wide","title":"Get dataset overview","href":"/api-reference/v2/get-dataset-overview"},{"openapi":"get /v2/team/datasets","mode":"wide","title":"List datasets","href":"/api-reference/v2/list-datasets"},{"openapi":"post /v2/team/datasets/{id}","title":"Modify dataset","href":"/api-reference/v2/modify-dataset"},{"openapi":"delete /v2/team/datasets/{id}","title":"Delete dataset","href":"/api-reference/v2/delete-dataset"}]},{"group":"Data sources","pages":[{"openapi":"POST /v2/team/datasets/{id}/datasources","title":"Create data source","href":"/api-reference/v2/create-data-source"},{"openapi":"POST /v2/team/datasources","title":"Create data source without specifying a dataset","href":"/api-reference/v2/create-data-source-without-dataset"},{"openapi":"get /v2/team/datasets/{dataset_id}/datasources/{datasource_id}","mode":"wide","title":"Get data source","href":"/api-reference/v2/get-data-source"},{"openapi":"get /v2/team/datasets/{id}/datasources","mode":"wide","title":"List data sources","href":"/api-reference/v2/list-data-sources"},{"openapi":"delete /v2/team/datasets/{dataset_id}/datasources/{datasource_id}","title":"Delete data source","href":"/api-reference/v2/delete-data-source"},{"openapi":"post /v2/team/datasets/{dataset_id}/datasources/{datasource_id}/presign","title":"Presign data source ","href":"/api-reference/v2/presign-data-source"}]},{"group":"Files","pages":[{"openapi":"post /v2/team/file/upload-datasource","mode":"wide","title":"Upload local file","href":"/api-reference/v2/upload-file"},{"openapi":"post /v2/team/file/init-multipart-upload","title":"Initiate multipart upload","href":"/api-reference/v2/initiate-multipart-upload"},{"openapi":"post /v2/team/file/complete-multipart-upload","title":"Complete multipart upload","description":"Completes a multipart upload task after all parts of the corresponding file are uploaded.\n\n## Important notes\n\nWhen calling this endpoint, you must provide a full list of uploaded parts, including their sequential numbers and corresponding ETag values. Cloud Object Storage service (for example, AWS S3) validates each part in sequence and, upon successful verification, combines them into a complete file.","href":"/api-reference/v2/complete-multipart-upload"}]},{"group":"Sessions","pages":[{"openapi":"post /v2/team/sessions","title":"Create session","href":"/api-reference/v2/create-session"},{"openapi":"get /v2/team/sessions/{id}","description":"Obtains information about a session you created.","mode":"wide","title":"Get session","href":"/api-reference/v2/get-session"},{"openapi":"get /v2/team/sessions/{id}/history","mode":"wide","title":"Get job history in session","href":"/api-reference/v2/get-job-history"},{"openapi":"get /v2/team/sessions","mode":"wide","title":"List sessions","href":"/api-reference/v2/list-sessions"},{"openapi":"post /v2/team/sessions/{id}","title":"Modify session","href":"/api-reference/v2/modify-session"},{"openapi":"delete /v2/team/sessions/{id}","title":"Delete session","href":"/api-reference/v2/delete-session"}]},{"group":"Jobs","pages":[{"openapi":"post /v2/team/jobs","title":"Create job","href":"/api-reference/v2/create-job"}]}]},{"anchor":"Open API V1 (Deprecated)","icon":"dice-one","pages":[{"title":"Open API V1 (Deprecated)","href":"/api-reference/overview"}]}]}]},"basePath":"","title":"Create session - Powerdrill","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}