A valid request URL is required to generate request examples{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Delete a point rule
Requires engagement:manage. This really deletes the rule and keeps the ledger. Every line it wrote carries the rule’s key and name copied at award time, so nobody’s statement breaks and nobody’s balance moves — which is what makes retiring a rule an ordinary act rather than a destructive one.
It is refused while an event_count badge counts this rule, and the refusal names how many: a badge whose rule is gone can never be unlocked, and it would sit on the shelf looking earnable forever.
PATCH { "active": false } is the reversible off switch; this is for the rule written by mistake.
A valid request URL is required to generate request examples{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Authorizations
A staff session token, uk_st_…. Minted by sign-up, sign-in or the two-factor exchange. Only a 401 means it is spent; not_a_member (403) is about the organization named in X-Organization-Id and leaves the token good for the others.
Headers
The organization the caller is acting on — the org_… code that appears in the panel URL. It identifies; the membership JOIN is what authorizes, so a forged code reads nothing: the answer is not_a_member (403), which does not mean the session is over. Absent, the session's default organization answers, or — if that membership was revoked while the session was open — any other one the caller still holds.
Path Parameters
The rule's id.
Response
Deleted. The ledger is untouched.