GIgitlab
usage_data

Track an internal GitLab 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.

post/api/v4/usage_data/track_event

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Request body

eventstring required

The event name that should be tracked

namespace_idinteger

Namespace ID

project_idinteger

Project ID

project_pathstring

Project path (used to resolve project_id if not provided)

additional_propertiesobject

Additional properties to be tracked

send_to_snowplowboolean

Send the tracked event to Snowplow

Example request

{
  "event": "i_quickactions_page",
  "namespace_id": 1234,
  "project_id": 1234,
  "project_path": "namespace/project",
  "additional_properties": {
    "label": "login_button",
    "value": 1
  },
  "send_to_snowplow": true
}

Response

Track an internal GitLab event

Changes

No recorded changes to this operation across all 5 revisions of this API.