v1

latestOpenAPI 3.0.1Apache 2.02026-07-1476137102.3 KB
Organizations

List All Machines

List all Machines associated with a specific organization. Machines are sorted by their updated_at timestamps, oldest to newest.

This API call represents "a point in time". Recent machine changes, including creations and destructions, may take time to propagate. When polling with updated_after, offset your timestamps to catch late-arriving events.

get/orgs/{org_slug}/machines

Path parameters

org_slugstring required

Fly Organization Slug

Query parameters

include_deletedboolean

Include deleted machines

regionstring

Region filter

statestring

Comma separated list of states to filter (created, started, stopped, suspended)

summaryboolean

Omit config from responses

updated_afterstring

Only return machines updated after this time. Timestamp must be in the RFC 3339 format

cursorstring

Pagination cursor from previous response (takes precedence over updated_after). Note that there is no guarantee that all machines returned by this endpoint are sorted by their updated_at fields. Pagination may reveal machines older than the last updated_at.

limitinteger

The number of machines to fetch (max of 1000). This limit is advisory. Responses may be shorter, or even empty, even when more machines remain. If omitted, the maximum is used

Response

OK

error_regionsstring[]
last_machine_idstring
last_updated_atstring
next_cursorstring