POST /v1/counters/{counterId}/decrement
Decrement the value by 1 (only if the counter mode permits decrement operations). Returns the new value.
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
https://developers.counttogether.app/v1/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/decrement
Response (200):
12500
Possible Errors
HTTP | Code | Reason |
|---|---|---|
400 | InvalidOperationForCounterType | Counter type not UpDown or mode disallows operation |
401 | (auth) | Missing or invalid token |
403 | (authz) | User not a member / lacks permission |
404 | NotFound | Counter does not exist or not visible |
Realtime Integration
Successful mutations emit a JSON-RPC notification with method: "counterUpdated" containing the updated state.
Idempotency
Not idempotent. Repeating the same POST increments/decrements again.
Rate Limiting
These requests count towards the same sliding window user limit. Excessive mutation may lead to 429 responses.
Last modified: 16 March 2026