POST /v2/counters/{counterId}/decrement[/{amount}]

Decrements an UpDown counter. The optional amount path segment sets the step size (must be ≥ 1, defaults to 1).

# Decrement by 1
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  https://developers.counttogether.app/v2/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/decrement

# Decrement by 3
curl -X POST -H "Authorization: Bearer YOUR_TOKEN" \
  https://developers.counttogether.app/v2/counters/018f5b54-9b11-7c33-b347-a2b4e2a6a111/decrement/3

Response (200)

12447

The new numeric value is returned as a plain number.

Possible Errors

HTTP	Code	Reason
400	—	`amount` is ≤ 0
400	InvalidOperationForCounterType	Counter is not UpDown or mode disallows decrement
401	—	Missing or invalid token
403	—	User not a member / lacks permission
404	NotFound	Counter not found

Realtime Integration

Successful decrements emit a counterUpdated WebSocket notification.

Idempotency

Not idempotent — each POST applies the decrement again.

21 April 2026