---
title: "Patch budget planning grid"
method: PATCH
path: "/v1/budgets/{id}/planning"
tags: ["Budgets"]
---

# Patch budget planning grid

`PATCH /v1/budgets/{id}/planning`

## Request

- Base URL: `https://api.nops.io`
- URL: `https://api.nops.io/v1/budgets/{id}/planning`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nops/apis/nops-public-api/docs/v1/budgets/:id/planning/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: Budget ID

## Headers

- `Idempotency-Key` string, required: Unique key for safe retries on write requests (required, max 64 characters).

## Request body

- object: JSON request body

## Response `200`

Patch budget planning grid

- object
  - `data` object, required: JSON object

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `403`: Forbidden — insufficient permissions or entitlement

---

[API](https://skmtc.dev/nops/apis/nops-public-api.md) - [All operations](https://skmtc.dev/nops/apis/nops-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nops/apis/nops-public-api/revisions/ac549fa495dd?raw)