---
title: "Delete one budget"
method: DELETE
path: "/admin/budgets"
tags: ["admin"]
---

# Delete one budget

`DELETE /admin/budgets`

## Request body

- AdminDeleteBudgetRequest
  - `budget_key` union, required
    - object
      - `period` string, required
      - `period_seconds` integer
    - object
      - `period` string
      - `period_seconds` integer, required
  - `scope` string
  - `subject` string
  - `user_path` string

## Response `200`

OK

- AdminBudgetListResponse
  - `budgets` AdminBudgetStatusResponse[]
    - `amount` number
    - `created_at` string
    - `effective_subject` string
    - `has_usage` boolean
    - `last_reset_at` string
    - `per_child` boolean
    - `period_end` string
    - `period_label` string
    - `period_ratio` number
    - `period_seconds` integer
    - `period_start` string
    - `remaining` number
    - `scope` string
    - `source` string
    - `spent` number
    - `subject` string
    - `updated_at` string
    - `usage_ratio` number
    - `user_path` string
  - `server_time` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `503` — Service Unavailable

## Changes

> 53 revisions in range; 1 could not be searched.

- **2026-08-16** `f28ae401e426` — 2 info
  - added the optional property `budgets/items/effective_subject` to the response with the `200` status
  - added the optional property `budgets/items/per_child` to the response with the `200` status
- **2026-07-25** `6da0dc2745e2` — 4 info
  - added the new optional request property `scope`
  - added the new optional request property `subject`
  - added the optional property `budgets/items/scope` to the response with the `200` status
  - added the optional property `budgets/items/subject` to the response with the `200` status
- **2026-05-09** `1236749560f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/admin/budgets/delete.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/7b5727a74f59/schema)