Submit Command Logs

`POST` /v1/minecraft/players/command-log

Submit a batch of command log entries from your server. Each entry records a command executed by a player.

Authentication

Requires the X-API-Key header with your server's API key.

X-API-Key: your-api-key-here

Request

Headers

Header	Type	Required	Description
`X-API-Key`	string	Yes	Your server's API key.
`Content-Type`	string	Yes	Must be `application/json`.

Body

Field	Type	Required	Description
`entries`	array	Yes	Array of command log entries (max 500). Must not be empty.

Each entry in the entries array:

Field	Type	Required	Description
`uuid`	string	Yes	The player's Minecraft UUID.
`username`	string	Yes	The player's Minecraft username.
`command`	string	Yes	The command that was executed.
`timestamp`	long	Yes	The Unix timestamp of the command in milliseconds (min: 0).
`server`	string	No	The server where the command was executed.

{
  "entries": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "username": "Notch",
      "command": "/gamemode creative",
      "timestamp": 1699000000000,
      "server": "survival-1"
    }
  ]
}

Response

`200 OK`

An empty response body indicates the command logs were submitted successfully.

Error Responses

Status Code	Description
`400`	Invalid request body or missing required fields.
`401`	Missing or invalid API key.
`429`	Rate limit exceeded.
`500`	Internal server error.

Submit Command Logs

On this page