Users Management - Time Ban Reset
Endpoint
/o/users/reset_timeban
Overview
Resets failed-login time-ban state for one username.
Authentication
Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.
Permissions
- Global admin required.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | String | Yes (or use auth_token) | Dashboard API key. |
auth_token | String | Yes (or use api_key) | Dashboard auth token. |
username | String | Yes | Username whose failed-login ban record should be removed. |
Examples
Example 1: Reset lock for user
/o/users/reset_timeban?api_key=YOUR_API_KEY&username=jane
true
Response
Success Response
true
Response Fields
| Field | Type | Description |
|---|---|---|
(root) | Boolean | true when removal succeeds. |
Error Responses
Status Code: 500 Internal Server Error
{
"result": "Remove from collection failed."
}
Behavior
Behavior Modes
| Mode | Trigger | Response Shape |
|---|---|---|
| Reset success | Delete query executes without DB error | Raw boolean true. |
| Reset failure | DB remove operation errors | Wrapped error message. |
Limitations
- Endpoint targets
username, not user id.
Related Endpoints
Implementation details
Database Collections
| Collection | Used for | Data touched by this endpoint |
|---|---|---|
countly.failed_logins | Failed-login lock source. | Removes one lock counter record by username-based key. |