---
title: "Ingest markers"
method: POST
path: "/sdk/v1/markers/"
tags: ["Ingestion"]
---

# Ingest markers

`POST /sdk/v1/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.

## Headers

- `isstudio` union
  - boolean
  - 'true' | 'false'
- `project-id` integer
- `sdkversion` string
- `universeid` number
- `serverid` string

## Request body

- object
  - `markers` unknown[], required
    - unknown

## Response `200`

Default Response

- object
  - `message` string, required
  - `rejectedMarkersCount` number, required
  - `ingestedMarkersCount` number, required
  - `rejectedMarkers` object[]
    - `marker` unknown, required
    - `reason` string, required
  - `staleMarkersCount` number, required

## Other responses

- `400` — Default Response
- `403` — Default Response

---

[API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) · [All operations](https://skmtc.dev/gamebeast/apis/gamebeast-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gamebeast/gamebeast-api/revisions/e9940594b0cc/schema)