Read internal events

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

/o/data-manager/events/internal

Overview

Returns the stored drill metadata of the internal events that Data Manager exposes. In this release only the view event ([CLY]_view) is returned.

Authentication

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

Permissions

Requires data_manager Read permission.

Request Parameters

Parameter	Type	Required	Description
app_id	String	Yes	Target app ID.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Examples

Read internal events

/o/data-manager/events/internal?app_id=64f5c0d8f4f7ac0012ab3456

Response

Success Response

[
  {
    "app_id": "64f5c0d8f4f7ac0012ab3456",
    "e": "[CLY]_view"
  }
]

Response Fields

Field	Type	Description
(root array)	Array	One drill metadata document per internal event. Empty when the app has none.
app_id	String	App ID.
e	String	Event key.

The remaining fields of each document are the drill metadata stored for the event.

Error Responses

• HTTP 500:

{
  "result": "Error"
}

Behavior

• Reads the drill metadata of the app and keeps only events whose key is [CLY]_view.

Related Endpoints

• Events Extended - Read
• Event Segments - Read

Implementation details

Audit & System Logs

• This endpoint does not emit /systemlogs actions.

Database Collections

Collection	Used for	Data touched by this endpoint
countly_drill.drill_meta	Event metadata	Reads the metadata documents of the allowed internal events for the app.