---
title: "Set a project usage budget"
method: PUT
path: "/account/projects/{project}/budget"
tags: ["account"]
---

# Set a project usage budget

`PUT /account/projects/{project}/budget`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/account/projects/{project}/budget`
- Auth: HTTP bearer

Configures request budgets. A soft limit adds a warning header; a hard limit rejects requests with BUDGET_EXCEEDED.

When to use: Set project usage thresholds before automated or high-volume work.

## Path parameters

- `project` string, required

## Request body

- object
  - `period` 'month' | 'day': Window the budget counts over.
  - `softRequests` integer: Warn past this many accepted requests. null removes it.
  - `hardRequests` integer: Refuse past this many. null removes it.

## Response `200`

Set a project usage budget

- object
  - `schema` string
  - `budget` object, nullable

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)