---
title: "Update a workspace run cap control"
method: PATCH
path: "/v1/controls/workspace/run-caps/{runCapControlId}"
tags: ["Controls"]
---

# Update a workspace run cap control

`PATCH /v1/controls/workspace/run-caps/{runCapControlId}`

Patch limitAmount and/or status. At least one field is required.

## Path parameters

- `runCapControlId` string, required — Run cap control ID (ULID).

## Request body

- WorkspaceRunCapPatchRequest
  - `limitAmount` object
    - `currency` 'USD', required
    - `value` integer, required
    - `unit` 'MICRO_DOLLAR' | 'CENT' | 'DOLLAR', required
  - `status` 'ACTIVE' | 'PAUSED'

## Response `200`

Updated run cap control

- WorkspaceRunCap
  - `runCapControlId` string, required — Run cap control ID (ULID).
  - `workspaceId` string, required
  - `limitAmount` number, required — Per-run spending cap, in dollars.
  - `currency` 'USD', required
  - `status` 'ACTIVE' | 'PAUSED', required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad request — input failed validation
- `401` — Unauthorized — missing or invalid credentials
- `403` — Forbidden — caller has no workspace or no access
- `404` — Run cap control not found
- `500` — Internal server error

## Changes

- **2026-09-23** `fadab791136c` — 5 warning
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `400`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `401`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `403`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `404`
  - …1 more
- **2026-09-11** `9874d9e34fcf` — 5 info
  - added the optional property `errorCode` to the response with the `400` status
  - added the optional property `errorCode` to the response with the `401` status
  - added the optional property `errorCode` to the response with the `403` status
  - added the optional property `errorCode` to the response with the `404` status
  - …1 more

[Change history](https://skmtc.dev/monid/apis/monid-api/changes/v1/controls/workspace/run-caps/:runCapControlId/patch.md)

---

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