Decay Rule by ID API
Update or delete an individual decay rule.
PUT /decays/{id}
Update an existing decay rule.
Request
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Decay rule identifier (path parameter) |
Request Body
All fields are optional. Only provided fields will be updated.
| Field | Type | Description |
|---|---|---|
name | string | Rule name |
points | integer | Points to subtract per interval |
interval_days | integer | Days of inactivity before decay |
active | boolean | Whether rule is active |
Response
200 OK
Returns the updated decay rule.
Example
curl -X PUT "https://api.kenbun.io/decays/decay-123" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"points": -10, "active": true}'
Common Errors
| Status | Meaning | Solution |
|---|---|---|
| 401 | Unauthorized | Check authentication token |
| 404 | Not Found | Decay rule does not exist |
DELETE /decays/{id}
Delete a decay rule. This action cannot be undone.
Request
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Decay rule identifier (path parameter) |
Response
204 No Content
Successfully deleted.
Example
curl -X DELETE "https://api.kenbun.io/decays/decay-123" \
-H "Authorization: Bearer <token>"
Common Errors
| Status | Meaning | Solution |
|---|---|---|
| 401 | Unauthorized | Check authentication token |
| 404 | Not Found | Decay rule does not exist |
Notes
- Deleting a decay rule does not retroactively restore previously decayed scores
- Consider deactivating a rule (
active: false) instead of deleting it if you might need it later
Related Endpoints
- Decay Rules - List and create decay rules