SoulFire LogoSoulFire

Get log history

Retrieves historical log entries from the server's in-memory log buffer. The server maintains a rolling buffer of the last 300 log entries. Only returns non-personal logs that match the specified scope.

POST
/v1/logs:history

Retrieves historical log entries from the server's in-memory log buffer. The server maintains a rolling buffer of the last 300 log entries. Only returns non-personal logs that match the specified scope.

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

scope.instance.instance_id*string

The UUID of the instance to filter logs for. Must be a valid UUID string.

Formatuuid
scope.bot.instance_id*string

The UUID of the instance the bot belongs to. Must be a valid UUID string.

Formatuuid
scope.bot.bot_id*string

The UUID of the bot account to filter logs for. Must be a valid UUID string.

Formatuuid
scope.instance_script.instance_id*string

The UUID of the instance the script is running in. Must be a valid UUID string.

Formatuuid
scope.instance_script.script_id*string

The UUID of the script to filter logs for. Must be a valid UUID string.

Formatuuid
count*integer

The maximum number of recent log entries to retrieve. Must not exceed 300 (the server's maximum log buffer size). Returns the newest entries that match the scope, up to this count.

Formatint32

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://127.0.0.1:38765/v1/logs:history" \  -H "Content-Type: application/json" \  -d '{    "count": 0  }'
{  "messages": [    {      "id": "string",      "message": "string",      "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366",      "bot_account_id": "f11cad48-2194-4528-85a5-e18c181d7804",      "script_id": "74e7d8c3-daa9-40c1-ac0e-b64bfab79c57",      "personal": true,      "instance_name": "string",      "bot_account_name": "string",      "timestamp": {        "seconds": 0,        "nanos": 0      },      "logger_name": "string",      "level": "string"    }  ]}

How is this page?

Start login flow POST

Initiates a login flow for the specified email address. If the email is registered, a six-digit verification code is sent to that address. The response always indicates that an email code step is next, regardless of whether the email exists, to prevent email enumeration attacks.

Refresh Minecraft account POST

Refreshes the authentication tokens for an existing Minecraft account. Used to renew expired access tokens using stored refresh tokens. For Microsoft accounts, this refreshes the Minecraft token, profile, and player certificates. For offline accounts, returns the account unchanged (offline accounts never expire).