Track an internal GitLab event

POST

/api/v4/usage_data/track_event

• GitLab REST API

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

Authorizations

• http
• oauth2

Request Body^required

Media typeapplication/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

Responses

200

OK

400

Bad Request

401

Unauthorized

404

Not found