Recheck metadata lists
Ⓔ Enterprise Only
This API is available exclusively in Countly Enterprise.
Endpoint
/i/drill/recheck_lists
Overview
Starts a Drill metadata list recheck for one app or all apps.
Authentication
Countly API supports three authentication methods:
- API key query parameter:
api_key=YOUR_API_KEY - Auth token query parameter:
auth_token=YOUR_AUTH_TOKEN - Auth token header:
countly-token: YOUR_AUTH_TOKEN
Permissions
- Single-app recheck: requires
drillUpdatepermission. - All-app recheck: requires global admin.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | String | Conditional | Target app ID for single-app recheck. Required when all_apps is not set. |
all_apps | Boolean String | No | Set to any truthy value to recheck metadata lists for all apps. Requires global admin permission. |
api_key | String | Conditional | Required if auth_token is not provided. |
auth_token | String | Conditional | Required if api_key is not provided. |
Response
Success Response
{
"result": "List recheck started"
}
Response Fields
| Field | Type | Description |
|---|---|---|
result | String | Start confirmation message. |
Error Responses
This endpoint does not define a dedicated structured error payload beyond authentication/authorization errors. Recheck failures are logged and written to system logs.
Behavior/Processing
- Starts asynchronous metadata list recheck work and returns immediately.
- In all-app mode, iterates through all apps and rechecks lists for each app.
- In single-app mode, rechecks lists for the provided
app_id. - Writes completion/failure status to system logs with action
lists_rechecked.
Database Collections
| Collection | Used for | Data touched by this endpoint |
|---|---|---|
countly.apps | App iteration for all-app mode | Reads app IDs when all_apps is set. |
countly_drill.drill_meta | Drill metadata model | Rechecks and updates metadata list structures. |
countly.systemlogs | Audit trail | Stores lists_rechecked completion status. |
Examples
Single app recheck
/i/drill/recheck_lists?
app_id=64f5c0d8f4f7ac0012ab3456
All apps recheck
/i/drill/recheck_lists?
all_apps=true
Related Endpoints
Last Updated
2026-04-17