Lists datasets.
Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.
GET
/
v2
/
team
/
datasets
List datasets
curl --request GET \ --url https://ai.data.cloud/api/v2/team/datasets \ --header 'x-pd-api-key: <api-key>'
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.
{"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.3964","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":{},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/list-datasets","slug":"/api-reference/v2/list-datasets","pageMetadata":{"openapi":"get /v2/team/datasets","description":"Lists datasets.\nOnly datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.","mode":"wide","title":"List datasets","href":"/api-reference/v2/list-datasets"},"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 datasets.\\nOnly datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example request:`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`curl --request GET \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` --url https://ai.data.cloud/api/v2/team/datasets?user_id=tmm-dafasdfasdfasdf \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` --header 'x-pd-api-key: \u003capi-key>'`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`9`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://ai.data.cloud/api/v2/team/datasets?user_id=tmm-dafasdfasdfasdf\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"x-pd-api-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003capi-key>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.request(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, url, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(response.text)`})]}),`\n`]})})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example response:`})}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page_size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"records\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dataset-dasfadsgadsgas\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mysql\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mysql databases\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v2/team/datasets","description":"Lists datasets.\nOnly datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.","mode":"wide","title":"List datasets","href":"/api-reference/v2/list-datasets"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List datasets","deprecated":false,"description":"Lists datasets.\nOnly datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.","tags":["Dataset"],"parameters":["e812d03e-e6bd-4a7c-9787-8782f4f72229","7f54babd-d6ab-49b7-92d2-e21df75f5aeb","c00d1270-f5c1-4c88-ab2b-f1d9b0ab46f5","1acb346f-2e20-41b7-aa6a-688270e9fdea","1a3e009e-71d7-467c-b648-16340843f6aa"],"responses":{"200":"7461b3c0-556d-4a6f-845b-c4f8868cf71c"},"security":["2cc66cb0-a335-418b-a383-10e92b6e6efc"],"method":"get","type":"path","servers":["81ddd8d1-e0c9-427d-9d45-c7531fb084ca"],"path":"/v2/team/datasets","baseUrlOptions":["https://ai.data.cloud/api"],"title":"List datasets","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e812d03e-e6bd-4a7c-9787-8782f4f72229":{"name":"page_number","in":"query","description":"The page number to start listing. If not specified, the default value `1` will be used.","required":false,"schema":{"type":"integer","isRequired":false,"description":"The page number to start listing. If not specified, the default value `1` will be used.","uniqueKey":"","typeLabel":"integer"}},"7f54babd-d6ab-49b7-92d2-e21df75f5aeb":{"name":"page_size","in":"query","description":"The number of items on a single page. If not specified, the default value `10` will be used.","required":false,"schema":{"type":"integer","isRequired":false,"description":"The number of items on a single page. If not specified, the default value `10` will be used.","uniqueKey":"","typeLabel":"integer"}},"c00d1270-f5c1-4c88-ab2b-f1d9b0ab46f5":{"name":"search","in":"query","description":"The search keyword, which can be up to 128 characters in length. Datasets with names or descriptions containing this keyword will be listed. \n\nIf omitted, all datasets in the project will be listed.","required":false,"schema":{"type":"string","isRequired":false,"description":"The search keyword, which can be up to 128 characters in length. Datasets with names or descriptions containing this keyword will be listed. \n\nIf omitted, all datasets in the project will be listed.","uniqueKey":"","typeLabel":"string"}},"1acb346f-2e20-41b7-aa6a-688270e9fdea":{"name":"user_id","in":"query","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).","required":true,"schema":{"type":"string","isRequired":true,"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).","uniqueKey":"","typeLabel":"string"}},"1a3e009e-71d7-467c-b648-16340843f6aa":{"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"}}},"responses":{"7461b3c0-556d-4a6f-845b-c4f8868cf71c":{"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":{"type":"object","properties":{"page_number":{"type":"integer","description":"The page number of the current page.","isRequired":true,"uniqueKey":"data.page_number","typeLabel":"integer"},"page_size":{"type":"integer","description":"The number of items that are returned in a single page.","isRequired":true,"uniqueKey":"data.page_size","typeLabel":"integer"},"total_items":{"type":"integer","description":"The total number of datasets returned in the response.","isRequired":true,"uniqueKey":"data.total_items","typeLabel":"integer"},"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The dataset ID, which uniquely identifies the dataset.","isRequired":true,"uniqueKey":"data.records.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"The dataset name.","isRequired":true,"uniqueKey":"data.records.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"The dataset description.","isRequired":true,"uniqueKey":"data.records.items.[INDEX].description","typeLabel":"string"}},"required":["id","name","description"],"uniqueKey":"data.records.items.[INDEX]","typeLabel":"object"},"description":"A list of dataset objects.","isRequired":true,"uniqueKey":"data.records","typeLabel":"object[]"}},"required":["page_number","page_size","total_items","records"],"description":"The returned data object.","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data","code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":0,"data":{"page_number":1,"page_size":10,"total_items":1,"records":[{"id":"dataset-dasfadsgadsgas","name":"mysql","description":"mysql databases"}]}},"examples":{"Example":{"title":"Example","value":{"code":0,"data":{"page_number":1,"page_size":10,"total_items":1,"records":[{"id":"dataset-dasfadsgadsgas","name":"mysql","description":"mysql databases"}]}}}},"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":{"2cc66cb0-a335-418b-a383-10e92b6e6efc":{"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":"List datasets - Powerdrill","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T22:54:08.736Z","originalFileLocation":"api-reference/v2/list-datasets.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=\"Lists datasets. Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\">\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=\"List datasets - Powerdrill\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists datasets. Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\">\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/list-datasets\">\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=Datasets\u0026amp;title=List+datasets\u0026amp;description=Lists+datasets.%0AOnly+datasets+created+within+the+same+project+as+your+API+key+will+be+listed.+You+can+specify+a+search+keyword+to+filter+datasets+by+name+and+de\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=e5c0b8fc4d3b54693de52243a141fb449a9c4f6e45faae1aad47f8ee29c64848\">\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 datasets - Powerdrill\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists datasets. Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://powerdrill-55.mintlify.app/_mintlify/api/og/v2?division=Datasets\u0026amp;title=List+datasets\u0026amp;description=Lists+datasets.%0AOnly+datasets+created+within+the+same+project+as+your+API+key+will+be+listed.+You+can+specify+a+search+keyword+to+filter+datasets+by+name+and+de\u0026amp;theme=0c69e19070822010f03aecb8\u0026amp;signature=e5c0b8fc4d3b54693de52243a141fb449a9c4f6e45faae1aad47f8ee29c64848\">\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/list-datasets\">\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/list-datasets.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/list-datasets#webpage\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets\",\"name\":\"List datasets\",\"description\":\"Lists datasets. Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\",\"dateModified\":\"2026-01-06T22:54:08.736Z\",\"isPartOf\":{\"@id\":\"https://docs.powerdrill.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Datasets\",\"item\":\"https://docs.powerdrill.ai/api-reference/v2/create-dataset\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List datasets\",\"item\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets#apireference\",\"headline\":\"List datasets\",\"name\":\"List datasets\",\"description\":\"Lists datasets. Only datasets created within the same project as your API key will be listed. You can specify a search keyword to filter datasets by name and description.\",\"url\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets\",\"mainEntityOfPage\":{\"@id\":\"https://docs.powerdrill.ai/api-reference/v2/list-datasets#webpage\"},\"dateModified\":\"2026-01-06T22:54:08.736Z\",\"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","description":"Obtains the basic information about the dataset, including the keywords, description, and pre-generated questions.","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","description":"Modifies the name or description of specified 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","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}","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"}]}]}]},"title":"List datasets - Powerdrill","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-kQh739Uz.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}