---
updatedAt: 2026-08-31T16:44:28.000Z
agentTools:
  projectIndex: https://docs.ternary.app/llms.txt
---

# Check what deleting a budget affects

Return the reports and dashboards that reference this budget.

A read-only preflight for the delete confirmation. Deletion is not blocked by it: the reports keep working without their budget layer, and DELETE removes the references either way.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core API",
    "description": "Ternary Resource Management API",
    "version": "1.0.0",
    "contact": {},
    "license": {
      "name": "MIT",
      "identifier": "MIT"
    }
  },
  "tags": [
    {
      "name": "Budget",
      "description": "Manage budgets for tracking cloud spending."
    }
  ],
  "servers": [
    {
      "url": "https://core-api.ternary.app/api",
      "description": "Core API"
    },
    {
      "url": "https://core-api.eu.ternary.app/api",
      "description": "Core API (EU)"
    }
  ],
  "externalDocs": {
    "description": "Raw JSON",
    "url": "https://core-api.ternary.app/api/docs.json"
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "FailureResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP status code",
            "example": "400 - Bad Request"
          },
          "message": {
            "type": "string",
            "description": "Error message",
            "example": "ERROR_INVALID_PARAMS"
          },
          "reason": {
            "type": "string",
            "description": "Error reason code"
          }
        },
        "required": [
          "code",
          "message"
        ]
      },
      "FindBudgetDeletionImpactResponseBody": {
        "type": "object",
        "properties": {
          "impact": {
            "type": "object",
            "properties": {
              "dashboards": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Resource ID"
                    },
                    "name": {
                      "type": "string",
                      "description": "Resource name"
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ]
                },
                "description": "Dashboards that would lose a widget"
              },
              "reports": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Resource ID"
                    },
                    "name": {
                      "type": "string",
                      "description": "Resource name"
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ]
                },
                "description": "Reports that would lose a budget layer, limited to those the caller may view"
              },
              "reportsTotalCount": {
                "type": "integer",
                "description": "Every affected report, including those the caller cannot view"
              }
            },
            "required": [
              "dashboards",
              "reports",
              "reportsTotalCount"
            ]
          }
        },
        "required": [
          "impact"
        ]
      }
    }
  },
  "paths": {
    "/budgets/{budgetID}/deletion-impact": {
      "get": {
        "summary": "Check what deleting a budget affects",
        "tags": [
          "Budget"
        ],
        "operationId": "getBudgetDeletionImpact",
        "description": "Return the reports and dashboards that reference this budget.\n\nA read-only preflight for the delete confirmation. Deletion is not blocked by it: the reports keep working without their budget layer, and DELETE removes the references either way.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "description": "Unique budget ID",
              "example": "GExrxkUSjvnqKQ0Njedf"
            },
            "required": true,
            "description": "Unique budget ID",
            "name": "budgetID",
            "in": "path"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FindBudgetDeletionImpactResponseBody"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "400Response": {
                    "value": {
                      "code": "400 - Bad Request",
                      "message": "ERROR_INVALID_PARAMS"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "401Response": {
                    "value": {
                      "code": "401 - Unauthorized",
                      "message": "ERROR_UNAUTHORIZED"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FailureResponse"
                },
                "examples": {
                  "403Response": {
                    "value": {
                      "code": "403 - Forbidden",
                      "message": "ERROR_PERMISSION_DENIED"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "Core API",
      "tags": [
        "Alert Rule",
        "Alert Rule Events",
        "API Keys",
        "AWS Rate Recommendations",
        "Azure Rate Recommendations",
        "Billing Rules",
        "Budget",
        "Cases",
        "Cost Alerts",
        "Custom Label",
        "Custom Measures",
        "Data Integration",
        "Data Integration: Alibaba",
        "Data Integration: AWS",
        "Data Integration: Azure",
        "Data Integration: Custom Data",
        "Data Integration: Databricks",
        "Data Integration: GCP",
        "Data Integration: Oracle",
        "Data Integration: Snowflake",
        "Dimension Preferences",
        "GCP Rate Recommendations",
        "Integrations",
        "Label Map",
        "Measure Preferences",
        "MSP Billing Information",
        "MSP Child",
        "MSP Shared Payer Integrations",
        "MSP Tenant Settings",
        "Permissions",
        "Ramp Plans",
        "Report",
        "Resource Subscriptions",
        "Role",
        "Savings Opportunity Filter",
        "Scoped View",
        "Support Tickets",
        "Tenant",
        "Tenant SSO Config",
        "Usage Recommendations",
        "User",
        "User Group Config"
      ]
    }
  ]
}
```