PUT `/billing/alerts/{plan_id}`

Modify the threshold, notification channel, or status of an existing usage alert rule. Supports partial update; fields not passed retain their original values.

Billing Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`id`	`path`	`string`	Yes				Alert ID

Request Body

Schema: dto.UpdateUsageAlertRequest

Field	Type	Required
`name`	`string`	No
`notification_channels`	`string`	No
`resource_type`	`string`	No
`status`	`string`	No
`threshold_percent`	`integer`	No

Responses

Status	Description	Schema
200	Usage alert updated successfully	`dto.UsageAlertDetailResponse`
400	Invalid request parameters	`object`
401	Unauthorized	`object`
404	Alert not found	`object`
500	Internal server error	`object`

Referenced Schemas

dto.UsageAlertDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.UsageAlertResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.UsageAlertResponse

Field	Type	Required	Example
`app_id`	`string`	No	`app_001`
`created_at`	`string`	No	`2026-05-01T00:00:00Z`
`id`	`string`	No	`ua_001`
`last_triggered_at`	`string`	No	`2026-05-10T08:00:00Z`
`name`	`string`	No	`API call volume alert`
`notification_channels`	`string`	No	`email,in_app`
`resource_type`	`string`	No	`api_calls`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_xyz789`
`threshold_percent`	`integer`	No	`80`
`updated_at`	`string`	No	`2026-05-05T10:00:00Z`

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

PUT /billing/alerts/{plan_id}