---
title: "Report Roblox server state"
method: POST
path: "/sdk/v1/servers/roblox/{serverId}"
tags: ["Ingestion"]
---

# Report Roblox server state

`POST /sdk/v1/servers/roblox/{serverId}`

Reports the runtime state of a single Roblox game server (player count, place/job IDs, server metadata, etc.) keyed by `serverId`. The payload is formatted and ingested into our pipeline. Only Roblox-platform SDK keys may call this — other platforms receive a 403 with `INVALID_PLATFORM`.

## Path parameters

- `serverId` string, required

## Headers

- `isstudio` union
  - boolean
  - 'true' | 'false'
- `project-id` integer
- `sdkversion` string, required

## Request body

- object
  - `timestamp` unknown, required
  - `rootPlaceId` number, required
  - `universeId` number, required
  - `placeVersion` number, required
  - `players` string[], required
  - `metadata` object, required
    - `privateServerId` string
    - `privateServerOwnerId` string
    - `matchmakingType` string, required
    - `serverAgeSeconds` number, required
    - `serverMemoryUsage` object
      - `min` number, required
      - `max` number, required
      - `average` number, required
      - `median` number, required
      - `p25` number, required
      - `p75` number, required
      - `p90` number, required
      - `p99` number, required
    - `clientMemoryUsage` object
      - `min` number, required
      - `max` number, required
      - `average` number, required
      - `median` number, required
      - `p25` number, required
      - `p75` number, required
      - `p90` number, required
      - `p99` number, required
    - `serverFps` object
      - `min` number, required
      - `max` number, required
      - `average` number, required
      - `median` number, required
      - `p25` number, required
      - `p75` number, required
      - `p90` number, required
      - `p99` number, required
    - `clientFps` object
      - `min` number, required
      - `max` number, required
      - `average` number, required
      - `median` number, required
      - `p25` number, required
      - `p75` number, required
      - `p90` number, required
      - `p99` number, required
    - `clientPing` object
      - `min` number, required
      - `max` number, required
      - `average` number, required
      - `median` number, required
      - `p25` number, required
      - `p75` number, required
      - `p90` number, required
      - `p99` number, required

## Response `200`

Default Response

- object
  - `message` string, 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/801fbad9d8d0/schema)