To start fetching data in a dataset, you need to create a data request.
A data request is responsible with using your connections to fetch data from your data sources.
You can create a data request by using the Create a Data Request endpoint.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chartbrew Docs","colors":{"primary":"#048BDE","light":"#048BDE","dark":"#048BDE"},"logo":{"light":"https://mintcdn.com/chartbrew/iWQ6NZZBE_sjkVAv/logo/cb_logo_dark.svg?fit=max\u0026auto=format\u0026n=iWQ6NZZBE_sjkVAv\u0026q=85\u0026s=63c4d85b8d2a52c5c44a0d074fc0b0e1","dark":"https://mintcdn.com/chartbrew/iWQ6NZZBE_sjkVAv/logo/logo_dark_mode.svg?fit=max\u0026auto=format\u0026n=iWQ6NZZBE_sjkVAv\u0026q=85\u0026s=32cfcd9274d4d367a4f214e6677c4572"},"favicon":"https://mintcdn.com/chartbrew/YPArDehzXjtype0O/favicon.png?fit=max\u0026auto=format\u0026n=YPArDehzXjtype0O\u0026q=85\u0026s=3d8d07bd5c4cf5be4811910caa27cd44","api":{"playground":{"display":"interactive","proxy":false},"mdx":{"server":"http://localhost:4021"}},"navbar":{"links":[{"href":"https://github.com/chartbrew/chartbrew/issues","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.chartbrew.com"}},"footer":{"socials":{"x":"https://x.com/chartbrew","github":"https://github.com/chartbrew","linkedin":"https://linkedin.com/company/chartbrew"}},"seo":{"metatags":{"title":"Chartbrew Docs","og:title":"Chartbrew Docs","description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","og:description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","og:type":"website","og:image":"https://cdn2.chartbrew.com/banners/MainOG.png","og:url":"https://docs.chartbrew.com","twitter:card":"summary_large_image","twitter:title":"Chartbrew Docs","twitter:description":"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.","twitter:image":"https://cdn2.chartbrew.com/banners/MainOG.png","twitter:site":"@chartbrew"},"indexing":"navigable"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chartbrew.com"},{"anchor":"Community","icon":"Discord","href":"https://discord.gg/KwGEbFk"},{"anchor":"Blog","icon":"newspaper","href":"https://chartbrew.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/chartbrew/chartbrew"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chartbrew","hasAudioNarration":false,"actualSubdomain":"chartbrew","customDomains":["docs.chartbrew.com"],"gitSource":{"type":"github","owner":"chartbrew","repo":"chartbrew-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a8624fbc2199ff39d93f174","collectionId":"313dfd8a-fff2-42ee-b83d-e5f68d6d0589","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a8624fbc2199ff39d93f174"},"entitlements":{},"buildId":"6a8624fbc2199ff39d93f174:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":54},{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Charts","count":11},{"language":"default","tag":"Dashboards","count":10},{"language":"default","tag":"Connections","count":8},{"language":"default","tag":"Datasets","count":8},{"language":"default","tag":"Data Requests","count":7},{"language":"default","tag":"Build","count":6},{"language":"default","tag":"Chart-Dataset Configs","count":4},{"language":"default","tag":"Teams","count":4}]},"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/endpoint/datasets/create","slug":"/api-reference/endpoint/datasets/create","pageMetadata":{"title":"Create a dataset","description":"Create a new dataset","openapi":"POST /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/create"},"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: \"Create a new dataset\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsx(Note,{children:_jsxs(_components.p,{children:[`To start fetching data in a dataset, you need to create a data request.\nA data request is responsible with using your connections to fetch data from your data sources.\nYou can create a data request by using the `,_jsx(_components.a,{href:`/api-reference/endpoint/datasets/create-data-request`,children:`Create a Data Request`}),` endpoint.`]})})}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":{"title":"Create a dataset","description":"Create a new dataset","openapi":"POST /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Create a new dataset","parameters":["9ed382b4-30c4-4a52-b1d1-3016c07dce59"],"requestBody":"8faa072b-34a1-4015-b193-e79a902cbc3d","responses":{"200":"eabdc823-fc5b-4b46-ace7-b97d22ec450d","400":"eb60fb47-c05d-4fe2-8121-79a987b2527f","401":"35a2afdc-1c70-4123-bcf1-0836c0abb945"},"security":["bd065059-b58e-44d2-9759-6026d57e30d7"],"method":"post","type":"path","servers":["cd6cd87d-273a-41a4-965c-0c860142d061"],"path":"/team/{team_id}/datasets","baseUrlOptions":["https://api.chartbrew.com"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"9ed382b4-30c4-4a52-b1d1-3016c07dce59":{"name":"team_id","in":"path","description":"ID of the team","required":true,"schema":{"type":"string","isRequired":true,"description":"ID of the team","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["team_id"],"properties":{"team_id":{"type":"integer","isRequired":true,"uniqueKey":"team_id","typeLabel":"integer"},"project_ids":{"type":"array","items":{"type":"integer","uniqueKey":"project_ids.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"project_ids","typeLabel":"integer[]"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"connection_id":{"type":"integer","uniqueKey":"connection_id","typeLabel":"integer"},"type":{"type":"string","uniqueKey":"type","typeLabel":"string"},"query":{"type":"string","uniqueKey":"query","typeLabel":"string"},"datasetColor":{"type":"string","uniqueKey":"datasetColor","typeLabel":"string"},"dateField":{"type":"string","uniqueKey":"dateField","typeLabel":"string"},"dateFormat":{"type":"string","uniqueKey":"dateFormat","typeLabel":"string"},"legend":{"type":"string","description":"[Legacy compatibility] Previous dataset name field. Prefer name for reusable dataset naming.","uniqueKey":"legend","typeLabel":"string"},"configuration":{"type":"object","uniqueKey":"configuration","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"team_id":123,"project_ids":[123],"name":"\u003cstring>","connection_id":123,"type":"\u003cstring>","query":"\u003cstring>","datasetColor":"\u003cstring>","dateField":"\u003cstring>","dateFormat":"\u003cstring>","legend":"\u003cstring>","configuration":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"eabdc823-fc5b-4b46-ace7-b97d22ec450d":{"description":"Created dataset","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"team_id":{"type":"integer","uniqueKey":"team_id","typeLabel":"integer"},"project_ids":{"type":"array","items":{"type":"integer","uniqueKey":"project_ids.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"project_ids","typeLabel":"integer[]"},"chart_id":{"type":"integer","uniqueKey":"chart_id","typeLabel":"integer"},"connection_id":{"type":"integer","uniqueKey":"connection_id","typeLabel":"integer"},"draft":{"type":"boolean","default":true,"uniqueKey":"draft","typeLabel":"boolean"},"name":{"type":"string","description":"Canonical dataset name. Prefer this over legend when referring to the reusable dataset itself.","uniqueKey":"name","typeLabel":"string"},"query":{"type":"string","uniqueKey":"query","typeLabel":"string"},"xAxis":{"type":"string","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"xAxis","typeLabel":"string"},"xAxisOperation":{"type":"string","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"xAxisOperation","typeLabel":"string"},"yAxis":{"type":"string","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"yAxis","typeLabel":"string"},"yAxisOperation":{"type":"string","default":"none","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"yAxisOperation","typeLabel":"string"},"dateField":{"type":"string","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"dateField","typeLabel":"string"},"dateFormat":{"type":"string","description":"[Legacy compatibility] Dataset-level binding fallback. New chart bindings should be stored on ChartDatasetConfig.","uniqueKey":"dateFormat","typeLabel":"string"},"legend":{"type":"string","description":"[Legacy compatibility] Previous dataset name field. Prefer Dataset.name for reusable dataset naming.","uniqueKey":"legend","typeLabel":"string"},"fieldsSchema":{"type":"object","uniqueKey":"fieldsSchema","typeLabel":"object"},"excludedFields":{"type":"array","items":{"type":"string","uniqueKey":"excludedFields.items.[INDEX]","typeLabel":"string"},"uniqueKey":"excludedFields","typeLabel":"string[]"},"configuration":{"type":"object","uniqueKey":"configuration","typeLabel":"object"},"joinSettings":{"type":"object","properties":{"joins":{"type":"array","items":{"type":"object","properties":{"dr_id":{"type":"integer","description":"DataRequest ID","uniqueKey":"joinSettings.joins.items.[INDEX].dr_id","typeLabel":"integer"},"join_id":{"type":"integer","uniqueKey":"joinSettings.joins.items.[INDEX].join_id","typeLabel":"integer"},"dr_field":{"type":"string","uniqueKey":"joinSettings.joins.items.[INDEX].dr_field","typeLabel":"string"},"join_field":{"type":"string","uniqueKey":"joinSettings.joins.items.[INDEX].join_field","typeLabel":"string"}},"uniqueKey":"joinSettings.joins.items.[INDEX]","typeLabel":"object"},"uniqueKey":"joinSettings.joins","typeLabel":"object[]"}},"uniqueKey":"joinSettings","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"team_id":123,"project_ids":[123],"chart_id":123,"connection_id":123,"draft":true,"name":"\u003cstring>","query":"\u003cstring>","xAxis":"\u003cstring>","xAxisOperation":"\u003cstring>","yAxis":"\u003cstring>","yAxisOperation":"none","dateField":"\u003cstring>","dateFormat":"\u003cstring>","legend":"\u003cstring>","fieldsSchema":{},"excludedFields":["\u003cstring>"],"configuration":{},"joinSettings":{"joins":[{"dr_id":123,"join_id":123,"dr_field":"\u003cstring>","join_field":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"eb60fb47-c05d-4fe2-8121-79a987b2527f":{"description":"Error response","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"35a2afdc-1c70-4123-bcf1-0836c0abb945":{"description":"Not authorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"bd065059-b58e-44d2-9759-6026d57e30d7":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"cd6cd87d-273a-41a4-965c-0c860142d061":{"url":"https://api.chartbrew.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"chartbrew","siteName":"Chartbrew Docs","title":"Chartbrew Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-28T06:27:27.984Z","originalFileLocation":"api-reference/endpoint/datasets/create.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=\"Create a new dataset\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cdn2.chartbrew.com/banners/MainOG.png\">\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=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Chartbrew Documentation - Learn how to automate your reporting with Chartbrew.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cdn2.chartbrew.com/banners/MainOG.png\">\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/chartbrew/TDgfP0iapcicMV_Z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chartbrew Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#048BDE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/datasets/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chartbrew.com/#organization\",\"name\":\"Chartbrew Docs\",\"url\":\"https://docs.chartbrew.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chartbrew/iWQ6NZZBE_sjkVAv/logo/cb_logo_dark.svg?fit=max\u0026auto=format\u0026n=iWQ6NZZBE_sjkVAv\u0026q=85\u0026s=63c4d85b8d2a52c5c44a0d074fc0b0e1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chartbrew.com#website\",\"name\":\"Chartbrew Docs\",\"url\":\"https://docs.chartbrew.com\",\"publisher\":{\"@id\":\"https://docs.chartbrew.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create#webpage\",\"url\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create\",\"name\":\"Create a dataset\",\"description\":\"Create a new dataset\",\"dateModified\":\"2026-01-28T06:27:27.984Z\",\"isPartOf\":{\"@id\":\"https://docs.chartbrew.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Datasets\",\"item\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/info\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a dataset\",\"item\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create#apireference\",\"headline\":\"Create a dataset\",\"name\":\"Create a dataset\",\"description\":\"Create a new dataset\",\"url\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chartbrew.com/api-reference/endpoint/datasets/create#webpage\"},\"image\":\"https://cdn2.chartbrew.com/banners/MainOG.png\",\"dateModified\":\"2026-01-28T06:27:27.984Z\",\"publisher\":{\"@id\":\"https://docs.chartbrew.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chartbrew.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chartbrew Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Chartbrew Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://chartbrew.com"},{"anchor":"Community","icon":"Discord","href":"https://discord.gg/KwGEbFk"},{"anchor":"Blog","icon":"newspaper","href":"https://chartbrew.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/chartbrew/chartbrew"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Guides","pages":[{"title":"Create a chart from scratch","href":"/api-reference/guides/create-chart"}]},{"group":"Teams","pages":[{"title":"Get Team","openapi":"GET /team/{team_id}","href":"/api-reference/endpoint/team/get"},{"title":"Create Team","openapi":"POST /team","href":"/api-reference/endpoint/team/create"},{"title":"Get User Teams","openapi":"GET /team","href":"/api-reference/endpoint/team/get-user-teams"},{"title":"Update Team","openapi":"PUT /team/{team_id}","href":"/api-reference/endpoint/team/update"}]},{"group":"Dashboards","pages":[{"title":"What is a Dashboard?","href":"/api-reference/endpoint/dashboards/info"},{"title":"Get a dashboard","openapi":"GET /project/{id}","href":"/api-reference/endpoint/dashboards/get"},{"title":"List all dashboards","openapi":"GET /project/team/{team_id}","href":"/api-reference/endpoint/dashboards/list"},{"title":"Create a dashboard","openapi":"POST /project","href":"/api-reference/endpoint/dashboards/create"},{"title":"Update a Dashboard","openapi":"PUT /project/{id}","href":"/api-reference/endpoint/dashboards/update"},{"title":"Delete a dashboard","openapi":"DELETE /project/{id}","href":"/api-reference/endpoint/dashboards/delete"},{"title":"Create Dashboard Share Policy","openapi":"POST /project/{id}/share/policy","href":"/api-reference/endpoint/dashboards/create-share-policy"},{"title":"Update Dashboard Share Policy","openapi":"PUT /project/{id}/share/policy/{policy_id}","href":"/api-reference/endpoint/dashboards/update-share-policy"},{"title":"Delete Dashboard Share Policy","openapi":"DELETE /project/{id}/share/policy/{policy_id}","href":"/api-reference/endpoint/dashboards/delete-share-policy"},{"title":"Generate Dashboard Share Token","openapi":"POST /project/{id}/share/token","href":"/api-reference/endpoint/dashboards/generate-share-token"}]},{"group":"Connections","pages":[{"title":"What is a Connection?","href":"/api-reference/endpoint/connections/info"},{"title":"List connections","openapi":"GET /team/{team_id}/connections","href":"/api-reference/endpoint/connections/list"},{"title":"Get a connection","openapi":"GET /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/get"},{"title":"Create a connection","openapi":"POST /team/{team_id}/connections","href":"/api-reference/endpoint/connections/create"},{"title":"Update a connection","openapi":"PUT /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/update"},{"title":"Delete a connection","openapi":"DELETE /team/{team_id}/connections/{connection_id}","href":"/api-reference/endpoint/connections/delete"},{"title":"Update connection files","openapi":"POST /team/{team_id}/connections/{connection_id}/files","href":"/api-reference/endpoint/connections/update-files"},{"title":"Test a connection","openapi":"GET /team/{team_id}/connections/{connection_id}/test","href":"/api-reference/endpoint/connections/test"}]},{"group":"Datasets","pages":[{"title":"What is a Dataset?","href":"/api-reference/endpoint/datasets/info"},{"title":"List datasets","openapi":"GET /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/list"},{"title":"Get a dataset","openapi":"GET /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/get"},{"title":"Quick Create","description":"Quick create a dataset with all its data requests in one go.","openapi":"POST /team/{team_id}/datasets/quick-create","href":"/api-reference/endpoint/datasets/quick-create"},{"title":"Create a dataset","openapi":"POST /team/{team_id}/datasets","href":"/api-reference/endpoint/datasets/create"},{"title":"Update a dataset","description":"Update a dataset by ID","openapi":"PUT /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/update"},{"title":"Delete a dataset","openapi":"DELETE /team/{team_id}/datasets/{dataset_id}","href":"/api-reference/endpoint/datasets/delete"},{"title":"Fetch dataset data","openapi":"GET /team/{team_id}/datasets/{dataset_id}/request","href":"/api-reference/endpoint/datasets/fetch-dataset-data"}]},{"group":"Data Requests","pages":[{"title":"What is a Data Request?","href":"/api-reference/endpoint/datarequests/info"},{"title":"Create a Data Request","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests","href":"/api-reference/endpoint/datarequests/create"},{"title":"Get Dataset Data Requests","openapi":"GET /team/{team_id}/datasets/{dataset_id}/dataRequests","href":"/api-reference/endpoint/datarequests/list"},{"title":"Update a Data Request","openapi":"PUT /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}","href":"/api-reference/endpoint/datarequests/update"},{"title":"Run a Data Request","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/request","href":"/api-reference/endpoint/datarequests/run"},{"title":"Create a Variable Binding","openapi":"POST /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/variableBindings","href":"/api-reference/endpoint/datarequests/create-variablebinding"},{"title":"Update a Variable Binding","openapi":"PUT /team/{team_id}/datasets/{dataset_id}/dataRequests/{id}/variableBindings/{variable_id}","href":"/api-reference/endpoint/datarequests/update-variablebinding"}]},{"group":"Charts","pages":[{"title":"What is a Chart?","href":"/api-reference/endpoint/charts/info"},{"title":"Get a chart","openapi":"GET /project/{project_id}/chart/{id}","href":"/api-reference/endpoint/charts/get"},{"title":"Quick Create Chart","openapi":"POST /project/{project_id}/chart/quick-create","href":"/api-reference/endpoint/charts/quick-create"},{"title":"Create a chart","openapi":"POST /project/{project_id}/chart","href":"/api-reference/endpoint/charts/create"},{"title":"Query a chart","openapi":"POST /project/{project_id}/chart/{id}/query","href":"/api-reference/endpoint/charts/query"},{"title":"Delete a chart","openapi":"DELETE /project/{project_id}/chart/{id}","href":"/api-reference/endpoint/charts/delete"},{"title":"Get Chart for Sharing","openapi":"GET /chart/share/{share_string}","href":"/api-reference/endpoint/charts/share-chart"},{"title":"Create Chart Share Policy","openapi":"POST /project/{project_id}/chart/{id}/share/policy","href":"/api-reference/endpoint/charts/create-share-policy"},{"title":"Update Chart Share Policy","openapi":"PUT /project/{project_id}/chart/{chart_id}/share/policy/{policy_id}","href":"/api-reference/endpoint/charts/update-chart-share-policy"},{"title":"Delete Chart Share Policy","openapi":"DELETE /project/{project_id}/chart/{chart_id}/share/policy/{policy_id}","href":"/api-reference/endpoint/charts/delete-chart-share-policy"},{"title":"Generate Chart Share Token","openapi":"POST /project/{project_id}/chart/{id}/share/token","href":"/api-reference/endpoint/charts/generate-share-token"}]},{"group":"Chart-Dataset Configs","pages":[{"title":"What is a Chart-Dataset Config?","href":"/api-reference/endpoint/chartdatasetconfigs/info"},{"title":"Create a chart config","openapi":"POST /project/{project_id}/chart/{id}/chart-dataset-config","href":"/api-reference/endpoint/chartdatasetconfigs/create"},{"title":"Update a chart config","openapi":"PUT /project/{project_id}/chart/{id}/chart-dataset-config/{cdc_id}","href":"/api-reference/endpoint/chartdatasetconfigs/update"},{"title":"Delete a chart config","openapi":"DELETE /project/{project_id}/chart/{id}/chart-dataset-config/{cdc_id}","href":"/api-reference/endpoint/chartdatasetconfigs/delete"}]}]}]},"title":"Chartbrew Docs","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","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","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.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"]}