Skip to content

Track an internal GitLab event

POST
/api/v4/usage_data/track_event

Tracks a GitLab internal event. This action increments Service Ping counters in Redis and is optionally sent to Snowplow. Introduced in GitLab 16.2.

Media type application/json
object
event
required

The event name that should be tracked

string
nullable
Example
i_quickactions_page
namespace_id

Namespace ID

integer
nullable
Example
1234
project_id

Project ID

integer
nullable
Example
1234
project_path

Project path (used to resolve project_id if not provided)

string
nullable
Example
namespace/project
additional_properties

Additional properties to be tracked

object
Example
{
"label": "login_button",
"value": 1
}
send_to_snowplow

Send the tracked event to Snowplow

boolean
nullable
Example
true

OK

Bad Request

Unauthorized

Not found