Budgets

Monthly spend caps per project. Budgets watch month-to-date usage at rate-card prices and flag (or, with hard stop, will suspend) overruns.

budgets.get

Get the project’s budget and month-to-date spend.

GET /v1/orgs/{orgId}/projects/{projectId}/budget

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: member
Risk: read

Example

curl "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/budget" \
  -H "Authorization: Bearer korve_..."

Responses

Status	Description
`200`	The budget.
`404`	No budget configured for this project.

Response body (200)

Field	Type	Description
`monthlyCapUsd`	number	—
`hardStop`	boolean	Whether spend past the cap suspends the project’s paid activity.
`alertAtPercent`	integer	Alert threshold as a percent of the cap.
`currentSpendUsd`	number	Month-to-date spend at rate-card prices.

budgets.set

Create or replace the project’s budget. Omitted optional fields reset to defaults.

PUT /v1/orgs/{orgId}/projects/{projectId}/budget

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: admin
Billing: requires active organization billing — returns 402 otherwise.
Risk: write

Request body

Field	Type	Required	Description
`monthlyCapUsd`	number	Yes	Monthly cap in USD. Must be > 0.
`hardStop`	boolean	No	Defaults to false.
`alertAtPercent`	integer	No	1-100. Defaults to 80.

Example

curl -X PUT "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/budget" \
  -H "Authorization: Bearer korve_..." \
  -H "Content-Type: application/json" \
  -d '{
  "monthlyCapUsd": 50,
  "hardStop": false,
  "alertAtPercent": 80
}'

Responses

Status	Description
`200`	Budget stored.
`402`	Organization billing is not active.
`404`	No such project in this organization.
`422`	Invalid cap, hard stop flag, or alert threshold.

Response body (200)

Field	Type	Description
`monthlyCapUsd`	number	—
`hardStop`	boolean	Whether spend past the cap suspends the project’s paid activity.
`alertAtPercent`	integer	Alert threshold as a percent of the cap.
`currentSpendUsd`	number	Month-to-date spend at rate-card prices.

budgets.delete

Remove the project’s budget. Usage keeps accruing, uncapped.

DELETE /v1/orgs/{orgId}/projects/{projectId}/budget

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: admin
Risk: destructive

Example

curl -X DELETE "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/budget" \
  -H "Authorization: Bearer korve_..."

Responses

Status	Description
`200`	Budget removed.
`404`	No budget configured for this project.

Getting started

Agents

Primitives

API reference

CLI reference

budgets.get

Example

Responses

Response body (200)

budgets.set

Request body

Example

Responses

Response body (200)

budgets.delete

Example

Responses

​budgets.get

​Example

​Responses

​Response body (200)

​budgets.set

​Request body

​Example

​Responses

​Response body (200)

​budgets.delete

​Example

​Responses

budgets.get

Example

Responses

Response body (200)

budgets.set

Request body

Example

Responses

Response body (200)

budgets.delete

Example

Responses