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/alerts-v2/create-a-budget-alert","slug":"/api-reference/alerts-v2/create-a-budget-alert","pageMetadata":{"title":"Create a budget alert","description":"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.","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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\"\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":"Create a budget alert","description":"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.","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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createBudgetAlertV2","summary":"Create a budget alert","description":"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.","tags":["Alerts V2"],"security":["5d763754-af48-461b-88da-c27d808c7380"],"requestBody":"f4903b72-fa83-4104-8572-4b1678ec46a2","responses":{"200":"dc5446a6-c380-45c0-b8f4-00f3071d5eaa","401":"d6553a75-e405-4e78-a8f0-b6928796ce20","403":"d230108a-ae60-439a-99db-14647430eea6"},"method":"post","type":"path","servers":["cd9d6d3a-8758-4ae6-beb1-6dc3f3c2c6de"],"path":"/alerts-v2/budgetAlerts","baseUrlOptions":[""],"title":"Create a budget alert","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"parentBudgetId":{"type":"string","isRequired":true,"uniqueKey":"parentBudgetId","typeLabel":"string"},"selectedVirtualDimensionValues":{"type":"array","items":{"type":"string","uniqueKey":"selectedVirtualDimensionValues.items.[INDEX]","typeLabel":"string"},"minItems":1,"isRequired":true,"uniqueKey":"selectedVirtualDimensionValues","typeLabel":"string[]"},"thresholds":{"type":"array","items":{"type":"object","properties":{"severityLevel":{"type":"string","enum":["INFO","WARNING","RED"],"isRequired":true,"uniqueKey":"thresholds.items.[INDEX].severityLevel","typeLabel":"enum\u003cstring>"},"value":{"type":"number","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"thresholds.items.[INDEX].value","typeLabel":"number"}},"required":["severityLevel","value"],"uniqueKey":"thresholds.items.[INDEX]","typeLabel":"object"},"minItems":1,"maxItems":3,"isRequired":true,"uniqueKey":"thresholds","typeLabel":"object[]"},"notification":{"oneOf":[{"type":"object","required":["notificationChannel","slackChannelId"],"properties":{"notificationChannel":{"type":"string","enum":["SLACK"],"isRequired":true,"uniqueKey":"notification.oneOf.0.notificationChannel","typeLabel":"enum\u003cstring>"},"slackChannelId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"notification.oneOf.0.slackChannelId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"notification.oneOf.0","typeLabel":"object"},{"type":"object","required":["notificationChannel","teamsChannelId"],"properties":{"notificationChannel":{"type":"string","enum":["TEAMS"],"isRequired":true,"uniqueKey":"notification.oneOf.1.notificationChannel","typeLabel":"enum\u003cstring>"},"teamsChannelId":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"notification.oneOf.1.teamsChannelId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"notification.oneOf.1","typeLabel":"object"},{"type":"object","required":["notificationChannel","emails"],"properties":{"notificationChannel":{"type":"string","enum":["EMAIL"],"isRequired":true,"uniqueKey":"notification.oneOf.2.notificationChannel","typeLabel":"enum\u003cstring>"},"emails":{"type":"array","items":{"type":"string","format":"email","uniqueKey":"notification.oneOf.2.emails.items.[INDEX]","typeLabel":"string\u003cemail>"},"minItems":1,"isRequired":true,"uniqueKey":"notification.oneOf.2.emails","typeLabel":"string\u003cemail>[]"},"shouldNotifyLineOwners":{"type":"boolean","default":false,"uniqueKey":"notification.oneOf.2.shouldNotifyLineOwners","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"notification.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"notification","typeLabel":"object"},"conditionType":{"type":"string","enum":["ACTUAL_SPEND","FORECASTED_EOM"],"default":"ACTUAL_SPEND","uniqueKey":"conditionType","typeLabel":"enum\u003cstring>"}},"required":["name","parentBudgetId","selectedVirtualDimensionValues","thresholds","notification"],"uniqueKey":"","typeLabel":"object"},"example":{"name":"Platform team monthly budget burn","parentBudgetId":"cm7q2g4w90001w3e8b9x4k2pn","conditionType":"FORECASTED_EOM","selectedVirtualDimensionValues":["Platform","Shared infrastructure"],"thresholds":[{"severityLevel":"RED","value":100},{"severityLevel":"WARNING","value":90},{"severityLevel":"INFO","value":75}],"notification":{"notificationChannel":"SLACK","slackChannelId":"C06FINOPS42"}},"examples":{"Example":{"title":"Example","value":{"name":"Platform team monthly budget burn","parentBudgetId":"cm7q2g4w90001w3e8b9x4k2pn","conditionType":"FORECASTED_EOM","selectedVirtualDimensionValues":["Platform","Shared infrastructure"],"thresholds":[{"severityLevel":"RED","value":100},{"severityLevel":"WARNING","value":90},{"severityLevel":"INFO","value":75}],"notification":{"notificationChannel":"SLACK","slackChannelId":"C06FINOPS42"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"dc5446a6-c380-45c0-b8f4-00f3071d5eaa":{"description":"Budget alert created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"organizationId":{"type":"string","isRequired":true,"uniqueKey":"organizationId","typeLabel":"string"},"createdAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time> | null"},"createdById":{"type":"string","isRequired":true,"uniqueKey":"createdById","typeLabel":"string"},"archivedAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"archivedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"archivedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"archivedAt","typeLabel":"string\u003cdate-time> | null"},"snoozedUntil":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"snoozedUntil.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"snoozedUntil.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"snoozedUntil","typeLabel":"string\u003cdate-time> | null"},"name":{"type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"selectedVirtualDimensionValues":{"type":"array","items":{"type":"string","uniqueKey":"selectedVirtualDimensionValues.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"selectedVirtualDimensionValues","typeLabel":"string[]"},"notificationChannel":{"type":"string","enum":["EMAIL","SLACK","TEAMS"],"isRequired":true,"uniqueKey":"notificationChannel","typeLabel":"enum\u003cstring>"},"emails":{"type":"array","items":{"type":"string","format":"email","uniqueKey":"emails.items.[INDEX]","typeLabel":"string\u003cemail>"},"isRequired":true,"uniqueKey":"emails","typeLabel":"string\u003cemail>[]"},"shouldNotifyLineOwners":{"type":"boolean","isRequired":true,"uniqueKey":"shouldNotifyLineOwners","typeLabel":"boolean"},"slackChannelId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"slackChannelId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"slackChannelId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"slackChannelId","typeLabel":"string | null"},"teamsChannelId":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"teamsChannelId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"teamsChannelId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"teamsChannelId","typeLabel":"string | null"},"conditionType":{"type":"string","enum":["ACTUAL_SPEND","FORECASTED_EOM"],"isRequired":true,"uniqueKey":"conditionType","typeLabel":"enum\u003cstring>"},"parentBudgetId":{"type":"string","isRequired":true,"uniqueKey":"parentBudgetId","typeLabel":"string"}},"required":["id","organizationId","createdAt","createdById","archivedAt","snoozedUntil","name","selectedVirtualDimensionValues","notificationChannel","emails","shouldNotifyLineOwners","slackChannelId","teamsChannelId","conditionType","parentBudgetId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","organizationId":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","createdById":"\u003cstring>","archivedAt":"2023-11-07T05:31:56Z","snoozedUntil":"2023-11-07T05:31:56Z","name":"\u003cstring>","selectedVirtualDimensionValues":["\u003cstring>"],"notificationChannel":"EMAIL","emails":["jsmith@example.com"],"shouldNotifyLineOwners":true,"slackChannelId":"\u003cstring>","teamsChannelId":"\u003cstring>","conditionType":"ACTUAL_SPEND","parentBudgetId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d6553a75-e405-4e78-a8f0-b6928796ce20":{"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"},"d230108a-ae60-439a-99db-14647430eea6":{"description":"Budget is not accessible to the caller","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5d763754-af48-461b-88da-c27d808c7380":{"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":"Create a budget alert - Costory Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/alerts-v2/create-a-budget-alert.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=\"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\">\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=\"Create a budget alert - Costory Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\">\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/alerts-v2/create-a-budget-alert\">\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=Alerts+V2\u0026amp;title=Create+a+budget+alert\u0026amp;description=Creates+an+alert+for+budget+lines+visible+to+the+caller.+Threshold+percentages+are+ordered+from+highest+severity+to+lowest.\u0026amp;theme=1281d3dcbd6f73a9ab3b217e\u0026amp;signature=3de922c81a22b3c77250f9147573990fb6327c759043b79ae16dbab2e8b8a20e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a budget alert - Costory Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://costory.mintlify.site/_mintlify/api/og/v2?division=Alerts+V2\u0026amp;title=Create+a+budget+alert\u0026amp;description=Creates+an+alert+for+budget+lines+visible+to+the+caller.+Threshold+percentages+are+ordered+from+highest+severity+to+lowest.\u0026amp;theme=1281d3dcbd6f73a9ab3b217e\u0026amp;signature=3de922c81a22b3c77250f9147573990fb6327c759043b79ae16dbab2e8b8a20e\">\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/alerts-v2/create-a-budget-alert\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/alerts-v2/create-a-budget-alert.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/alerts-v2/create-a-budget-alert#webpage\",\"url\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert\",\"name\":\"Create a budget alert\",\"description\":\"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\",\"isPartOf\":{\"@id\":\"https://docs.costory.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Alerts V2\",\"item\":\"https://docs.costory.io/api-reference/alerts-v2/list-cost-and-budget-alerts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a budget alert\",\"item\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert#apireference\",\"headline\":\"Create a budget alert\",\"name\":\"Create a budget alert\",\"description\":\"Creates an alert for budget lines visible to the caller. Threshold percentages are ordered from highest severity to lowest.\",\"url\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert\",\"mainEntityOfPage\":{\"@id\":\"https://docs.costory.io/api-reference/alerts-v2/create-a-budget-alert#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/alerts-v2/create-a-budget-alert.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","description":null,"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","description":null,"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","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","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":"Create a budget alert - 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"]}