POST /v1/counters/{counterId}/increment
Increment the value of an UpDown counter by 1. Returns the new numeric value as a plain number.
Request example:
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
https://developers.counttogether.app/v1/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/increment
Response (200):
12501
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