Public API

Ganti anggaran proyek

Management key required. Mengganti seluruh batas belanja dan peringatan; pengaturan yang dihilangkan akan dihapus.

PUT
/public/v1/projects/{project_id}/budget

Management key required. Use a Management API Key (mgmt-...) for your Team, created by a Team Owner.

Replace the entire budget policy. Resend every setting you want to retain: omitted or null monetary fields become zero, and an omitted alert percentage becomes zero. A zero limit means unlimited; a zero alert amount disables that alert. Sending {} clears all limits and alerts.

Existing usage is preserved. Repeating the same request does not reset spending. Concurrent or in-flight requests and delayed settlement can produce a small overspend. Archived projects cannot be modified.

Authorization

ManagementKeyBearer
AuthorizationBearer <token>

Management key required. Send Authorization: Bearer mgmt-....

In: header

Path Parameters

project_id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Zero, null or omitted monetary fields mean unlimited (limits) or disabled (alerts). Percentage alerts require a positive monthly_limit. The existing project budget periods and usage accounting apply.

Daily and monthly limits follow UTC calendar periods; weeks start Monday at 00:00 UTC. total_limit covers cumulative project usage. Updating a budget preserves existing usage.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/public/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/budget" \  -H "Content-Type: application/json" \  -d '{    "monthly_limit": {      "value": "200.00",      "currency": "usd"    },    "usage_alert_percent": 80  }'
{  "daily_limit": {    "value": "0.00000000",    "currency": "usd"  },  "weekly_limit": {    "value": "0.00000000",    "currency": "usd"  },  "monthly_limit": {    "value": "200.00000000",    "currency": "usd"  },  "total_limit": {    "value": "0.00000000",    "currency": "usd"  },  "daily_alert": {    "value": "0.00000000",    "currency": "usd"  },  "monthly_alert": {    "value": "0.00000000",    "currency": "usd"  },  "usage_alert_percent": 80,  "object": "project_budget",  "project_id": "019a6eab-7c00-7000-8000-000000000123",  "request_id": "req_example"}

Last updated on