Skip to main content
GET
/
api
/
v3
/
builds
List builds
curl --request GET \
  --url https://playflow.dev/api/api/v3/builds \
  --header 'api-key: <api-key>'
{
  "builds": [
    {
      "build_id": "<string>",
      "name": "<string>",
      "version": 123,
      "status": "uploading",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "build_type": "zip",
      "executable_path": "<string>",
      "image_url": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "has_more": true
}

Authorizations

api-key
string
header
required

Query Parameters

name
string

Filter builds by name (e.g., "default", "beta"). Returns all names if omitted.

limit
integer
default:50

Maximum builds per page (1–100). Defaults to 50.

Required range: 1 <= x <= 100
offset
integer | null
default:0

Number of builds to skip for pagination. Defaults to 0.

Required range: x >= 0

Response

200 - application/json

Paginated list of builds.

Paginated list of game server builds.

builds
object[]
required

Array of builds for the current page.

total
number
required

Total number of builds matching the query filters.

limit
number
required

Maximum number of items per page.

offset
number
required

Number of items skipped (for pagination).

has_more
boolean
required

True if there are more builds beyond this page.