Skip to main content

Decay Rule by ID API

Update or delete an individual decay rule.

PUT /decays/{id}

Update an existing decay rule.

Request

ParameterTypeRequiredDescription
idstringYesDecay rule identifier (path parameter)

Request Body

All fields are optional. Only provided fields will be updated.

FieldTypeDescription
namestringRule name
pointsintegerPoints to subtract per interval
interval_daysintegerDays of inactivity before decay
activebooleanWhether rule is active

Response

200 OK

Returns the updated decay rule.

Example

curl -X PUT "https://api.leadvibe.com/decays/decay-123" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"points": -10, "active": true}'

Common Errors

StatusMeaningSolution
401UnauthorizedCheck authentication token
404Not FoundDecay rule does not exist

DELETE /decays/{id}

Delete a decay rule. This action cannot be undone.

Request

ParameterTypeRequiredDescription
idstringYesDecay rule identifier (path parameter)

Response

204 No Content

Successfully deleted.

Example

curl -X DELETE "https://api.leadvibe.com/decays/decay-123" \
-H "Authorization: Bearer <token>"

Common Errors

StatusMeaningSolution
401UnauthorizedCheck authentication token
404Not FoundDecay 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