Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.
Send Authorization: Bearer <credential> using either a Clerk session JWT or a Clerk API key (ak_*). API keys may identify a user (user_*) or organization (org_*) principal and are generated in the Clerk Dashboard under API keys.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Costory Documentation","colors":{"primary":"#1D3C93","light":"#305DD9","dark":"#1D3C93"},"logo":{"light":"https://mintcdn.com/costory/jdghijjvsrOsYiTC/logo/light.png?fit=max\u0026auto=format\u0026n=jdghijjvsrOsYiTC\u0026q=85\u0026s=dee63acdba91bf952855557cc5c5ec16","dark":"https://mintcdn.com/costory/jdghijjvsrOsYiTC/logo/light.png?fit=max\u0026auto=format\u0026n=jdghijjvsrOsYiTC\u0026q=85\u0026s=dee63acdba91bf952855557cc5c5ec16","href":"https://costory.io"},"favicon":"https://mintcdn.com/costory/stODLWETeKeyz7ed/favicon-new.svg?fit=max\u0026auto=format\u0026n=stODLWETeKeyz7ed\u0026q=85\u0026s=334ff5307103e4ffc0473bb6e1b9b56c","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://costory.io","label":"Website"}],"primary":{"type":"button","label":"Start a free trial","href":"https://app.costory.io/welcome-demo?utm_source=get-started"}},"integrations":{"posthog":{"apiKey":"phc_jgU0iQbU4Arfu5ouKpn9YhzkTWv3P5VfW2n7sJsKR0P","apiHost":"https://user.costory.io","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude","aistudio"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"costory","hasAudioNarration":false,"actualSubdomain":"costory","customDomains":["docs.costory.io"],"gitSource":{"type":"github","owner":"costory-io","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af2033088844f4e905da51d","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":124},{"language":"default","tag":"Documentation","count":70},{"language":"default","tag":"Setup","count":44},{"language":"default","tag":"Alerts V2","count":26},{"language":"default","tag":"Dashboards","count":23},{"language":"default","tag":"Billing Data","count":22},{"language":"default","tag":"Use Cases","count":17},{"language":"default","tag":"Reports","count":16},{"language":"default","tag":"Metrics Correlation","count":13},{"language":"default","tag":"Events","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/dimensions/list-label-keys-that-could-become-dimensions","slug":"/api-reference/dimensions/list-label-keys-that-could-become-dimensions","pageMetadata":{"title":"List label keys that could become dimensions","description":"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. `ingested: true` means the key is already promoted.","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions/candidates","href":"/api-reference/dimensions/list-label-keys-that-could-become-dimensions","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. \", _jsx(_components.code, {\n children: \"ingested: true\"\n }), \" means the key is already promoted.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List label keys that could become dimensions","description":"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. `ingested: true` means the key is already promoted.","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions/candidates","href":"/api-reference/dimensions/list-label-keys-that-could-become-dimensions","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listDimensionCandidates","summary":"List label keys that could become dimensions","description":"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. `ingested: true` means the key is already promoted.","tags":["Dimensions"],"security":["2a3712e9-1ab8-475d-b73f-7c9dce6ca489"],"responses":{"200":"39a0fdd3-df85-435f-be43-af666a49b865","401":"44de1100-c72d-4b2e-9fbe-26f79d2fa94f"},"method":"get","type":"path","servers":["cd9d6d3a-8758-4ae6-beb1-6dc3f3c2c6de"],"path":"/dimensions/candidates","baseUrlOptions":[""],"title":"List label keys that could become dimensions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"39a0fdd3-df85-435f-be43-af666a49b865":{"description":"Candidate label keys with cost-allocation stats","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"usage_start_day":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].usage_start_day.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].usage_start_day.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].usage_start_day","typeLabel":"string\u003cdate-time> | null"},"key":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].key","typeLabel":"string"},"number_values":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].number_values.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].number_values.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].number_values","typeLabel":"number | null"},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].values.items.[INDEX].value","typeLabel":"string"},"cost_allocated":{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].values.items.[INDEX].cost_allocated","typeLabel":"number"},"proportion_cost_allocated":{"type":"number","uniqueKey":"items.[INDEX].values.items.[INDEX].proportion_cost_allocated","typeLabel":"number"}},"required":["value","cost_allocated"],"uniqueKey":"items.[INDEX].values.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].values","typeLabel":"object[]"},"total_cost_key_present":{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].total_cost_key_present","typeLabel":"number"},"total_cost_key_absent":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].total_cost_key_absent.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].total_cost_key_absent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].total_cost_key_absent","typeLabel":"number | null"},"id":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"proportion_key_present":{"type":"number","uniqueKey":"items.[INDEX].proportion_key_present","typeLabel":"number"},"proportion_key_absent":{"type":"number","uniqueKey":"items.[INDEX].proportion_key_absent","typeLabel":"number"},"providers":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].providers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].providers","typeLabel":"string[]"},"months":{"type":"array","items":{"type":"object","additionalProperties":{"oneOf":[{"type":"number","uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.1","typeLabel":"null"},{"type":"string","format":"date-time","uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.2","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.3","typeLabel":"null"},{"type":"string","enum":[null],"uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.4","typeLabel":"enum\u003cstring>"},{"type":"null","enum":[null],"uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties.oneOf.5","typeLabel":"null"}],"uniqueKey":"items.[INDEX].months.items.[INDEX].additionalProperties","typeLabel":"number · null · string\u003cdate-time> · null · enum\u003cstring> · null"},"uniqueKey":"items.[INDEX].months.items.[INDEX]","typeLabel":"object"},"default":[],"uniqueKey":"items.[INDEX].months","typeLabel":"object[]"},"cost_percentage_change":{"oneOf":[{"type":"number","uniqueKey":"items.[INDEX].cost_percentage_change.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"items.[INDEX].cost_percentage_change.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].cost_percentage_change","typeLabel":"number | null"},"ingested":{"type":"boolean","uniqueKey":"items.[INDEX].ingested","typeLabel":"boolean"}},"required":["usage_start_day","key","number_values","values","total_cost_key_present","total_cost_key_absent","id"],"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"usage_start_day":"2023-11-07T05:31:56Z","key":"\u003cstring>","number_values":123,"values":[{"value":"\u003cstring>","cost_allocated":123,"proportion_cost_allocated":123}],"total_cost_key_present":123,"total_cost_key_absent":123,"id":"\u003cstring>","proportion_key_present":123,"proportion_key_absent":123,"providers":["\u003cstring>"],"months":[],"cost_percentage_change":123,"ingested":true}]}},"exampleType":"generated"}},"exampleType":"generated"},"44de1100-c72d-4b2e-9fbe-26f79d2fa94f":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Unauthorized error message","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2a3712e9-1ab8-475d-b73f-7c9dce6ca489":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT or Clerk ak_* API key","description":"Send `Authorization: Bearer \u003ccredential>` using either a Clerk session JWT or a Clerk API key (`ak_*`). API keys may identify a user (`user_*`) or organization (`org_*`) principal and are generated in the Clerk Dashboard under API keys.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"cd9d6d3a-8758-4ae6-beb1-6dc3f3c2c6de":{"url":"","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT or Clerk ak_* API key","description":"Send `Authorization: Bearer \u003ccredential>` using either a Clerk session JWT or a Clerk API key (`ak_*`). API keys may identify a user (`user_*`) or organization (`org_*`) principal and are generated in the Clerk Dashboard under API keys.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send `Authorization: Bearer \u003ccredential>` using either a Clerk session JWT or a Clerk API key (`ak_*`). API keys may identify a user (`user_*`) or organization (`org_*`) principal and are generated in the Clerk Dashboard under API keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://app-api.costory.io/docs/openapi.json"},"subdomain":"costory","siteName":"Costory Documentation","title":"List label keys that could become dimensions - Costory Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/dimensions/list-label-keys-that-could-become-dimensions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Costory Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintcdn.com/costory/stODLWETeKeyz7ed/favicon-new.svg?fit=max\u0026amp;auto=format\u0026amp;n=stODLWETeKeyz7ed\u0026amp;q=85\u0026amp;s=334ff5307103e4ffc0473bb6e1b9b56c\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintcdn.com/costory/stODLWETeKeyz7ed/favicon-new.svg?fit=max\u0026amp;auto=format\u0026amp;n=stODLWETeKeyz7ed\u0026amp;q=85\u0026amp;s=334ff5307103e4ffc0473bb6e1b9b56c\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintcdn.com/costory/stODLWETeKeyz7ed/favicon-new.svg?fit=max\u0026amp;auto=format\u0026amp;n=stODLWETeKeyz7ed\u0026amp;q=85\u0026amp;s=334ff5307103e4ffc0473bb6e1b9b56c\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintcdn.com/costory/stODLWETeKeyz7ed/favicon-new.svg?fit=max\u0026amp;auto=format\u0026amp;n=stODLWETeKeyz7ed\u0026amp;q=85\u0026amp;s=334ff5307103e4ffc0473bb6e1b9b56c\">\u003cmeta data-mint-head property=\"og:title\" content=\"List label keys that could become dimensions - Costory Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Costory Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://costory.mintlify.site/_mintlify/api/og/v2?division=Dimensions\u0026amp;title=List+label+keys+that+could+become+dimensions\u0026amp;description=Label+keys+found+in+the+billing+data+with+the+cost-allocation+stats+used+to+judge+whether+promoting+them+is+worthwhile%3A+the+share+of+cost+carrying+the+key%2C+its+\u0026amp;theme=1281d3dcbd6f73a9ab3b217e\u0026amp;signature=8fd3af29f5e782d72175ce284e98097d00a39b98483784581750c5528938e7ce\">\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 label keys that could become dimensions - Costory Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://costory.mintlify.site/_mintlify/api/og/v2?division=Dimensions\u0026amp;title=List+label+keys+that+could+become+dimensions\u0026amp;description=Label+keys+found+in+the+billing+data+with+the+cost-allocation+stats+used+to+judge+whether+promoting+them+is+worthwhile%3A+the+share+of+cost+carrying+the+key%2C+its+\u0026amp;theme=1281d3dcbd6f73a9ab3b217e\u0026amp;signature=8fd3af29f5e782d72175ce284e98097d00a39b98483784581750c5528938e7ce\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/costory/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Costory Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D3C93\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/dimensions/list-label-keys-that-could-become-dimensions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.costory.io/#organization\",\"name\":\"Costory Documentation\",\"url\":\"https://docs.costory.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/costory/jdghijjvsrOsYiTC/logo/light.png?fit=max\u0026auto=format\u0026n=jdghijjvsrOsYiTC\u0026q=85\u0026s=dee63acdba91bf952855557cc5c5ec16\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.costory.io#website\",\"name\":\"Costory Documentation\",\"url\":\"https://docs.costory.io\",\"publisher\":{\"@id\":\"https://docs.costory.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions#webpage\",\"url\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions\",\"name\":\"List label keys that could become dimensions\",\"description\":\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.\",\"isPartOf\":{\"@id\":\"https://docs.costory.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dimensions\",\"item\":\"https://docs.costory.io/api-reference/dimensions/list-queryable-dimensions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List label keys that could become dimensions\",\"item\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions#apireference\",\"headline\":\"List label keys that could become dimensions\",\"name\":\"List label keys that could become dimensions\",\"description\":\"Label keys found in the billing data with the cost-allocation stats used to judge whether promoting them is worthwhile: the share of cost carrying the key, its values, a per-month cost series, and the month-over-month change. Property names are snake_case because they come straight from the billing export. ingested: true means the key is already promoted.\",\"url\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.costory.io/api-reference/dimensions/list-label-keys-that-could-become-dimensions#webpage\"},\"publisher\":{\"@id\":\"https://docs.costory.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.costory.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Costory Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Costory Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/dimensions/list-label-keys-that-could-become-dimensions.md","siteName":"Costory Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/get-started/welcome"}]},{"tab":"Use Cases","icon":"lightbulb","pages":[{"title":"Use Cases","href":"/use-cases/overview"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Getting started","pages":[{"title":"API overview","sidebarTitle":"Overview","href":"/api-reference/overview"}]},{"group":"Query Costs API","pages":[{"title":"Query Costs API","sidebarTitle":"Overview","href":"/api-reference/queries/overview"},{"title":"Run a cost query","openapi":"POST /queries/run","href":"/api-reference/queries/run-a-cost-query"},{"title":"Run a cost-change diff tree","openapi":"POST /queries/diff-tree","href":"/api-reference/queries/run-a-cost-change-diff-tree"},{"title":"List queryable dimensions","openapi":"GET /queries/dimensions","href":"/api-reference/queries/list-queryable-dimensions"},{"title":"List business metrics","openapi":"GET /queries/metrics","href":"/api-reference/queries/list-business-metrics"},{"title":"List usage metrics","openapi":"GET /queries/usage-metrics","href":"/api-reference/queries/list-usage-metrics"}]},{"group":"Reports API","pages":[{"title":"Reports API","sidebarTitle":"Overview","href":"/api-reference/reports/overview"},{"title":"Create a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports","href":"/api-reference/reports/create-a-report"},{"title":"List reports","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /reports","href":"/api-reference/reports/list-reports"},{"title":"Get a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /reports/{id}","href":"/api-reference/reports/get-a-report"},{"title":"Update a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /reports/{id}","href":"/api-reference/reports/update-a-report"},{"title":"Duplicate a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports/{id}/duplicate","href":"/api-reference/reports/duplicate-a-report"},{"title":"Archive a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /reports/{id}","href":"/api-reference/reports/archive-a-report"},{"title":"Run a report now","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports/{reportId}/executions","href":"/api-reference/reports/run-a-report-now"}]},{"group":"Report Previews","pages":[{"title":"Send a test report","openapi":"POST /report-previews/deliveries","href":"/api-reference/reports/send-a-test-report"},{"title":"Preview a report widget","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-previews/widgets","href":"/api-reference/reports/preview-a-report-widget"}]},{"group":"Enrichments API","pages":[{"title":"Enrichments API","sidebarTitle":"Overview","href":"/api-reference/enrichments/overview"},{"title":"List live enrichments","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /enrichments","href":"/api-reference/enrichments/list-live-enrichments"},{"title":"Get one live enrichment document","openapi":"GET /enrichments/{name}","href":"/api-reference/enrichments/get-an-enrichment"},{"title":"Store an enrichment document as a draft","openapi":"PUT /enrichments/{name}","href":"/api-reference/enrichments/store-an-enrichment-draft"},{"title":"Draft the removal of an enrichment","openapi":"DELETE /enrichments/{name}","href":"/api-reference/enrichments/draft-an-enrichment-removal"},{"title":"Get pending enrichment drafts","openapi":"GET /enrichments/draft","href":"/api-reference/enrichments/get-enrichment-drafts"},{"title":"Discard pending enrichment drafts","openapi":"DELETE /enrichments/draft","href":"/api-reference/enrichments/discard-enrichment-drafts"},{"title":"Publish pending enrichment drafts","openapi":"POST /enrichments/draft/publish","href":"/api-reference/enrichments/publish-enrichment-drafts"},{"title":"List columns needed to trace a row","openapi":"GET /enrichments/trace-inputs","href":"/api-reference/enrichments/list-enrichment-trace-inputs"},{"title":"Trace one row through the enrichments","openapi":"POST /enrichments/explain","href":"/api-reference/enrichments/trace-an-enrichment-row"}]},{"group":"Alerts V2","pages":[{"title":"List cost and budget alerts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2","href":"/api-reference/alerts-v2/list-cost-and-budget-alerts"},{"title":"List alert templates","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/templates","href":"/api-reference/alerts-v2/list-alert-templates"},{"title":"Get an alert template","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/templates/{templateId}","href":"/api-reference/alerts-v2/get-an-alert-template"},{"title":"List budgets eligible for alerts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/budgets-with-alert-status","href":"/api-reference/alerts-v2/list-budgets-eligible-for-alerts"},{"title":"Snooze an alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/{alertId}/snooze","href":"/api-reference/alerts-v2/snooze-an-alert"},{"title":"Unsnooze an alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/{alertId}/unsnooze","href":"/api-reference/alerts-v2/unsnooze-an-alert"},{"title":"Archive an alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/{alertId}/archive","href":"/api-reference/alerts-v2/archive-an-alert"},{"title":"Restore an alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/{alertId}/restore","href":"/api-reference/alerts-v2/restore-an-alert"},{"title":"Delete an archived alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /alerts-v2/{alertId}","href":"/api-reference/alerts-v2/delete-an-archived-alert"},{"title":"List cost alerts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/costAlerts","href":"/api-reference/alerts-v2/list-cost-alerts"},{"title":"Create a cost alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/costAlerts","href":"/api-reference/alerts-v2/create-a-cost-alert"},{"title":"Get cost alert destination options","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/costAlerts/configurationFormData","href":"/api-reference/alerts-v2/get-cost-alert-destination-options"},{"title":"Duplicate a cost alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/costAlerts/{id}/duplicate","href":"/api-reference/alerts-v2/duplicate-a-cost-alert"},{"title":"Get cost alert editor data","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/costAlerts/{id}/edit","href":"/api-reference/alerts-v2/get-cost-alert-editor-data"},{"title":"Send a cost alert test notification","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/costAlerts/test","href":"/api-reference/alerts-v2/send-a-cost-alert-test-notification"},{"title":"Bulk update cost alert metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /alerts-v2/costAlerts/bulk/metadata","href":"/api-reference/alerts-v2/bulk-update-cost-alert-metadata"},{"title":"Bulk archive cost alerts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/costAlerts/bulk/archive","href":"/api-reference/alerts-v2/bulk-archive-cost-alerts"},{"title":"Bulk restore cost alerts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/costAlerts/bulk/restore","href":"/api-reference/alerts-v2/bulk-restore-cost-alerts"},{"title":"Update cost alert metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /alerts-v2/costAlerts/{id}/metadata","href":"/api-reference/alerts-v2/update-cost-alert-metadata"},{"title":"Update a cost alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /alerts-v2/costAlerts/{id}","href":"/api-reference/alerts-v2/update-a-cost-alert"},{"title":"Get cost alert widget data","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/costAlerts/{id}/widgetData","href":"/api-reference/alerts-v2/get-cost-alert-widget-data"},{"title":"Get cost alert firing history","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/costAlerts/{id}/history","href":"/api-reference/alerts-v2/get-cost-alert-firing-history"},{"title":"Create a budget alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/budgetAlerts","href":"/api-reference/alerts-v2/create-a-budget-alert"},{"title":"Get budget alert destination options","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /alerts-v2/budgetAlerts/configurationFormData","href":"/api-reference/alerts-v2/get-budget-alert-destination-options"},{"title":"Update a budget alert","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /alerts-v2/budgetAlerts/{budgetAlertId}","href":"/api-reference/alerts-v2/update-a-budget-alert"},{"title":"Send a budget alert test notification","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /alerts-v2/budgetAlerts/sendTest","href":"/api-reference/alerts-v2/send-a-budget-alert-test-notification"}]},{"group":"Dimensions","pages":[{"title":"List queryable dimensions","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions","href":"/api-reference/dimensions/list-queryable-dimensions"},{"title":"Search dimension values","description":"Full-text search across dimension names and their values. Unlike `GET /dimensions` this queries the billing warehouse live, so it is slower and costlier — use it for type-ahead, not to enumerate dimensions.","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions/search","href":"/api-reference/dimensions/search-dimension-values"},{"title":"List label keys that could become dimensions","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions/candidates","href":"/api-reference/dimensions/list-label-keys-that-could-become-dimensions"},{"title":"Get published label transformations","description":"The currently published label configuration: which source columns are merged into each engineered dimension and how their values are mapped. This is the live configuration, not a draft — the client holds label edits until it calls `POST /dimensions/publish`. `computeByName` is the per-label billing watermark (spinner, clock, or in sync). It is not part of the publish body.","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dimensions/labels","href":"/api-reference/dimensions/get-published-label-transformations"},{"title":"Publish pending dimension changes","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dimensions/publish","href":"/api-reference/dimensions/publish-pending-dimension-changes"},{"title":"Restrict label dimensions to org admins","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /dimensions/settings","href":"/api-reference/dimensions/restrict-label-dimensions-to-org-admins"}]},{"group":"Metrics","pages":[{"title":"List usage metrics","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /usage-metrics","href":"/api-reference/metrics/list-usage-metrics"}]},{"group":"Enrichments","pages":[{"title":"List live enrichments","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /enrichments","href":"/api-reference/enrichments/list-live-enrichments"},{"title":"Get pending enrichment drafts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /enrichments/draft","href":"/api-reference/enrichments/get-pending-enrichment-drafts"},{"title":"Discard pending enrichment drafts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /enrichments/draft","href":"/api-reference/enrichments/discard-pending-enrichment-drafts"},{"title":"Publish pending enrichment drafts","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /enrichments/draft/publish","href":"/api-reference/enrichments/publish-pending-enrichment-drafts"},{"title":"List columns needed to trace a row","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /enrichments/trace-inputs","href":"/api-reference/enrichments/list-columns-needed-to-trace-a-row"},{"title":"Trace one row through the enrichments","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /enrichments/explain","href":"/api-reference/enrichments/trace-one-row-through-the-enrichments"},{"title":"Get one live enrichment document","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /enrichments/{name}","href":"/api-reference/enrichments/get-one-live-enrichment-document"},{"title":"Store an enrichment document as a draft","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /enrichments/{name}","href":"/api-reference/enrichments/store-an-enrichment-document-as-a-draft"},{"title":"Draft the removal of an enrichment","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /enrichments/{name}","href":"/api-reference/enrichments/draft-the-removal-of-an-enrichment"}]},{"group":"Dashboards","pages":[{"title":"List dashboards","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/list","href":"/api-reference/dashboards/list-dashboards"},{"title":"List recently updated dashboards","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/recent","href":"/api-reference/dashboards/list-recently-updated-dashboards"},{"title":"List popular dashboards by view count","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/popular","href":"/api-reference/dashboards/list-popular-dashboards-by-view-count"},{"title":"Get a dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/{id}/full","href":"/api-reference/dashboards/get-a-dashboard"},{"title":"List saved dashboard versions","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/{id}/versions","href":"/api-reference/dashboards/list-saved-dashboard-versions"},{"title":"Get a dashboard version hydrate payload","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/{id}/versions/{versionId}","href":"/api-reference/dashboards/get-a-dashboard-version-hydrate-payload"},{"title":"Rename a saved dashboard version","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /dashboard-v2/{id}/versions/{versionId}","href":"/api-reference/dashboards/rename-a-saved-dashboard-version"},{"title":"Copy an old dashboard version into a new dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2/{id}/versions/{versionId}/copy","href":"/api-reference/dashboards/copy-an-old-dashboard-version-into-a-new-dashboard"},{"title":"Create a dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2","href":"/api-reference/dashboards/create-a-dashboard"},{"title":"Publish a dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /dashboard-v2/{id}","href":"/api-reference/dashboards/publish-a-dashboard"},{"title":"Delete a dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /dashboard-v2/{id}","href":"/api-reference/dashboards/delete-a-dashboard"},{"title":"Update dashboard metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /dashboard-v2/{id}/metadata","href":"/api-reference/dashboards/update-dashboard-metadata"},{"title":"Bulk update dashboard metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /dashboard-v2/bulk/metadata","href":"/api-reference/dashboards/bulk-update-dashboard-metadata"},{"title":"Bulk delete dashboards","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /dashboard-v2/bulk","href":"/api-reference/dashboards/bulk-delete-dashboards"},{"title":"List dashboard templates","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/templates","href":"/api-reference/dashboards/list-dashboard-templates"},{"title":"Clone a dashboard template","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2/templates/{templateId}/clone","href":"/api-reference/dashboards/clone-a-dashboard-template"},{"title":"Duplicate a dashboard","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2/{id}/duplicate","href":"/api-reference/dashboards/duplicate-a-dashboard"},{"title":"Publish a dashboard as a Costory template","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2/{id}/create-template","href":"/api-reference/dashboards/publish-a-dashboard-as-a-costory-template"},{"title":"Create a dashboard with an AI-generated title","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /dashboard-v2/create-from-intent","href":"/api-reference/dashboards/create-a-dashboard-with-an-ai-generated-title"},{"title":"Resolve a legacy id to a DashboardV2 id","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /dashboard-v2/legacy-redirect","href":"/api-reference/dashboards/resolve-a-legacy-id-to-a-dashboardv2-id"}]},{"group":"Reports","pages":[{"title":"List reports","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /reports","href":"/api-reference/reports/list-reports"},{"title":"Create a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports","href":"/api-reference/reports/create-a-report"},{"title":"Get a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /reports/{id}","href":"/api-reference/reports/get-a-report"},{"title":"Archive a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /reports/{id}","href":"/api-reference/reports/archive-a-report"},{"title":"Update a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /reports/{id}","href":"/api-reference/reports/update-a-report"},{"title":"Bulk update report metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /reports/bulk/metadata","href":"/api-reference/reports/bulk-update-report-metadata"},{"title":"Bulk archive reports","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /reports/bulk","href":"/api-reference/reports/bulk-archive-reports"},{"title":"Update report metadata","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /reports/{id}/metadata","href":"/api-reference/reports/update-report-metadata"},{"title":"Duplicate a report","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports/{id}/duplicate","href":"/api-reference/reports/duplicate-a-report"},{"title":"Run a report now","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /reports/{reportId}/executions","href":"/api-reference/reports/run-a-report-now"},{"title":"Get a report execution","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /report-executions/{executionId}","href":"/api-reference/reports/get-a-report-execution"},{"title":"Retry a failed report execution","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-executions/{executionId}/retry","href":"/api-reference/reports/retry-a-failed-report-execution"},{"title":"Transfer a rendered execution to new destinations","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-executions/{executionId}/transfers","href":"/api-reference/reports/transfer-a-rendered-execution-to-new-destinations"},{"title":"Send a test report delivery","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-previews/deliveries","href":"/api-reference/reports/send-a-test-report-delivery"},{"title":"Preview a report widget","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-previews/widgets","href":"/api-reference/reports/preview-a-report-widget"},{"title":"Preview digest summary markdown","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /report-previews/digest-summary","href":"/api-reference/reports/preview-digest-summary-markdown"}]},{"group":"Query Costs","pages":[{"title":"Run a cost query","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /queries/run","href":"/api-reference/query-costs/run-a-cost-query"},{"title":"Run a cost-change diff tree","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /queries/diff-tree","href":"/api-reference/query-costs/run-a-cost-change-diff-tree"},{"title":"List queryable dimensions","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /queries/dimensions","href":"/api-reference/query-costs/list-queryable-dimensions"},{"title":"List usage metrics","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /queries/usage-metrics","href":"/api-reference/query-costs/list-usage-metrics"},{"title":"List business metrics","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /queries/metrics","href":"/api-reference/query-costs/list-business-metrics"}]},{"group":"Events","pages":[{"title":"Create a new event","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /public/events","href":"/api-reference/events/create-a-new-event"},{"title":"Get event tags","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /events/tags","href":"/api-reference/events/get-event-tags"},{"title":"Get an event by ID","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /events/{id}","href":"/api-reference/events/get-an-event-by-id"},{"title":"Update an event","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /events/{id}","href":"/api-reference/events/update-an-event"},{"title":"Delete an event","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /events/{id}","href":"/api-reference/events/delete-an-event"},{"title":"Aggregate events","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /events/aggregate","href":"/api-reference/events/aggregate-events"},{"title":"Create a new event","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /events","href":"/api-reference/events/create-a-new-event-1"}]},{"group":"Admin","pages":[{"title":"Get service account details","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /terraform","href":"/api-reference/admin/get-service-account-details"}]},{"group":"Admin Billing Datasources","pages":[{"title":"Create a billing datasource","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /terraform/billingDatasources","href":"/api-reference/admin-billing-datasources/create-a-billing-datasource"},{"title":"Get a billing datasource","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /terraform/billingDatasources/{id}","href":"/api-reference/admin-billing-datasources/get-a-billing-datasource"},{"title":"Archive a billing datasource","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /terraform/billingDatasources/{id}","href":"/api-reference/admin-billing-datasources/archive-a-billing-datasource"},{"title":"Validate billing datasource configuration","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /terraform/billingDatasources/validate","href":"/api-reference/admin-billing-datasources/validate-billing-datasource-configuration"}]},{"group":"Admin Teams","pages":[{"title":"List teams in the organization via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /terraform/teams","href":"/api-reference/admin-teams/list-teams-in-the-organization-via-admin-api"},{"title":"Create a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /terraform/teams","href":"/api-reference/admin-teams/create-a-team-via-admin-api"},{"title":"Get a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /terraform/teams/{id}","href":"/api-reference/admin-teams/get-a-team-via-admin-api"},{"title":"Archive a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /terraform/teams/{id}","href":"/api-reference/admin-teams/archive-a-team-via-admin-api"},{"title":"Update a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json patch /terraform/teams/{id}","href":"/api-reference/admin-teams/update-a-team-via-admin-api"},{"title":"Add a member to a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /terraform/teams/{id}/members","href":"/api-reference/admin-teams/add-a-member-to-a-team-via-admin-api"},{"title":"Remove a member from a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json delete /terraform/teams/{id}/members/{userId}","href":"/api-reference/admin-teams/remove-a-member-from-a-team-via-admin-api"},{"title":"Sync all members of a team via Admin API","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /terraform/teams/{id}/SYNC","href":"/api-reference/admin-teams/sync-all-members-of-a-team-via-admin-api"}]},{"group":"Custom Metrics","pages":[{"title":"Push custom metric points","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json post /integrations/{id}/metrics/points","href":"/api-reference/custom-metrics/push-custom-metric-points"}]},{"group":"Access","pages":[{"title":"Get object access grants","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json get /access/{resourceKind}/{resourceId}","href":"/api-reference/access/get-object-access-grants"},{"title":"Replace object access grants","deprecated":null,"version":null,"openapi":"https://app-api.costory.io/docs/openapi.json put /access/{resourceKind}/{resourceId}/grants","href":"/api-reference/access/replace-object-access-grants"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"FinOps Memes","icon":"face-laugh-squint","pages":[{"title":"FinOps Memes","href":"/docs/finops-memes"}]}]},"basePath":"","title":"List label keys that could become dimensions - Costory Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}