---
title: "Update Client Budget"
method: PUT
path: "/clients/{client_id}/budget"
tags: ["Clients"]
---

# Update Client Budget

`PUT /clients/{client_id}/budget`

Create or replace the budget attached to a client. Send a complete budget object; partial updates are not supported.

## Path parameters

- `client_id` number, required

## Request body

- ClientBudget
  - `type` 'money' | 'time' | 'costs', required — Budget Type
  - `budget` number, required — Budget value in cents (for money) or seconds (for time)
  - `period` 'general' | 'monthly' | 'weekly' | 'daily' | 'quarterly' | 'yearly', required — Budget periodicity (overall, monthly, weekly, daily)
  - `appliedFrom` string, nullable — Start budget from (available only for non-recurrent budgets)
  - `disallowOverbudget` boolean
  - `excludeUnbillableTime` boolean
  - `excludeExpenses` boolean
  - `threshold` number — Email admins when threshold reached. Threshold is percentage 1 - 100.
  - `progress` number — Current budget usage in cents (for money) or seconds (for time)

## Response `200`

OK

- Client
  - `id` number, required
  - `name` string, required
  - `projects` string[], required — List of projects ID
  - `businessDetails` string, nullable
  - `budget` ClientBudget
    - `type` 'money' | 'time' | 'costs', required — Budget Type
    - `budget` number, required — Budget value in cents (for money) or seconds (for time)
    - `period` 'general' | 'monthly' | 'weekly' | 'daily' | 'quarterly' | 'yearly', required — Budget periodicity (overall, monthly, weekly, daily)
    - `appliedFrom` string, nullable — Start budget from (available only for non-recurrent budgets)
    - `disallowOverbudget` boolean
    - `excludeUnbillableTime` boolean
    - `excludeExpenses` boolean
    - `threshold` number — Email admins when threshold reached. Threshold is percentage 1 - 100.
    - `progress` number — Current budget usage in cents (for money) or seconds (for time)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/everhour/apis/everhour-api.md) · [All operations](https://skmtc.net/everhour/apis/everhour-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everhour/everhour-api/revisions/fc6136e33352/schema)