Change subscriber’s 4-digit PIN
Bearer olive_live_xxx or Bearer eyJ... (JWT)sub_abc123)| Rule | Invalid Example | Reason |
|---|---|---|
| Length | 123 | Must be 4 digits |
| Numeric | 12ab | Numbers only |
| Same as current | 1234 → 1234 | Must be different |
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PIN_FORMAT | PIN must be 4 digits |
| 400 | SAME_PIN | New PIN same as current |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 401 | WRONG_CURRENT_PIN | Current PIN incorrect |
| 403 | ACCOUNT_LOCKED | Too many failed attempts |
| 404 | NOT_FOUND | Subscriber not found |
| 500 | INTERNAL_ERROR | Server error |