Create or update a workspace budget | OpenRouter

Create or update the budget for a given interval. Budget limits must strictly decrease as the interval narrows (lifetime > monthly > weekly > daily). Management key required.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Path parameters

idstringRequired>=1 character

The workspace ID (UUID) or slug

intervalenumRequired

Budget reset interval. Use “lifetime” for a one-time budget that never resets.

Allowed values:

Request

This endpoint expects an object.

limit_usddoubleRequired

Spending limit in USD. Must be greater than 0.

Response

Budget created or updated successfully

dataobject

The created or updated budget

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

$	curl -X PUT https://openrouter.ai/api/v1/workspaces/production/budgets/monthly \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"limit_usd": 100
>	}'

1	{
2	"data": {
3	"created_at": "2025-08-24T10:30:00Z",
4	"id": "770e8400-e29b-41d4-a716-446655440000",
5	"limit_usd": 100,
6	"reset_interval": "monthly",
7	"updated_at": "2025-08-24T15:45:00Z",
8	"workspace_id": "550e8400-e29b-41d4-a716-446655440000"
9	}
10	}