Ingest markers

Ingests a batch of analytics markers (events) from the SDK. Each marker is platform-validated; invalid markers are returned in rejectedMarkers while valid ones are ingested into our pipeline. Billable markers (everything except platform-specific free types) count against the org's subscription usage and the request is rolled back if publishing fails. Returns counts of ingested, rejected, and stale markers.

Authorization

sdkApiKey

authorization<token>

SDK (public) key, prefixed gb_pk_ (older keys: sdk_). Send it as the authorization header value. Scoped to one project, so it is safe to ship in a game build.

In: header

Header Parameters

isstudio?|

Defaulttrue

project-id?integer

Range0 < value <= 9007199254740991

sdkversion?string

universeid?number

serverid?string

Lengthlength <= 100

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

markers*array<unknown>

Markers to ingest. Each is validated individually against the calling SDK's platform schema: valid markers are ingested and invalid ones are returned in rejectedMarkers.

Response Body

`application/json`

curl -X POST "https://example.com/sdk/v1/markers/" \  -H "Content-Type: application/json" \  -d '{    "markers": [      {        "type": "RoundEnded",        "timestamp": 1790000000,        "userId": "69935436",        "value": {          "Score": 600,          "Map": "Office",          "Duration": 120        }      }    ]  }'

{  "message": "string",  "rejectedMarkersCount": 0,  "ingestedMarkersCount": 0,  "rejectedMarkers": [    {      "marker": null,      "reason": "string"    }  ],  "staleMarkersCount": 0}

AuthorizationCopy Anchor Link

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

200application/json

400application/json

403application/json

Authorization

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`