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.