프로젝트 예산 교체
Management key required. 지출 한도와 알림을 모두 교체하며 생략한 설정은 해제됩니다.
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 Management key required. Send Authorization: Bearer mgmt-....
In: header
Path Parameters
uuidRequest 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