Recheck metadata lists

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/i/drill/recheck_lists

Overview

Starts a Drill metadata list recheck for one app or all apps.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Single-app recheck: requires drill Update permission.
• 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.

Examples

Single app recheck

/i/drill/recheck_lists?
  app_id=64f5c0d8f4f7ac0012ab3456

All apps recheck

/i/drill/recheck_lists?
  all_apps=true

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

• 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.

Related Endpoints

• Query Metadata - Read
• Metadata Cleanup - Update
• Metadata Regeneration - Update

Implementation details

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.