Skip to main content
GET
/
api
/
v3
/
servers
/
{instance_id}
/
logs
Get server runtime logs
curl --request GET \
  --url https://playflow.dev/api/api/v3/servers/{instance_id}/logs \
  --header 'api-key: <api-key>'
{
  "logs": [
    {
      "timestamp": "<string>",
      "message": "<string>",
      "level": "<string>",
      "instance": "<string>",
      "region": "<string>"
    }
  ],
  "instance_id": "<string>",
  "machine_id": "<string>",
  "next_token": "<string>"
}

Authorizations

api-key
string
header
required

Path Parameters

instance_id
string
required

Server instance ID.

Query Parameters

start_time
string

Fetch logs after this timestamp. Accepts ISO 8601 format (e.g., "2026-03-15T12:00:00Z") or relative time (e.g., "-1h", "-30m"). Omit to fetch from the beginning.

limit
integer
default:200

Maximum number of log entries to return (1–1000). Defaults to 200.

Required range: 1 <= x <= 1000

Response

Server runtime logs with pagination cursor.

Server runtime logs with pagination support.

logs
object[]
required

Array of log entries in chronological order.

instance_id
string
required

Server instance ID these logs belong to.

machine_id
string | null
required

Fly.io machine ID that produced these logs. Null if no machine is assigned (server never launched).

next_token
string | null
required

Pagination cursor. Pass this as start_time in the next request to fetch subsequent logs. Null if no more logs.