List All Volumes
List all volumes for an organization with optional filters and cursor-based pagination.
List all volumes for an organization with optional filters and cursor-based pagination.
Authorization
bearerAuth A Fly.io access token. Create one with fly tokens create.
In: header
Path Parameters
Fly Organization Slug
Query Parameters
Include deleted volumes
Region filter
Comma separated list of volume states to filter
Only return summary info about volumes (omit blocks, block size, etc)
Only return volumes updated after this time. Timestamp must be in the RFC 3339 format
Pagination cursor from previous response (takes precedence over updated_after)
The number of volumes to fetch (max of 1000). This limit is advisory. Responses may be shorter, even when more volumes remain. If omitted, the maximum is used
Response Body
application/json
curl -X GET "https://example.com/orgs/string/volumes"{ "last_updated_at": "string", "last_volume_id": "string", "next_cursor": "string", "volumes": [ { "app_name": "string", "attached_alloc_id": "string", "attached_machine_id": "string", "auto_backup_enabled": true, "block_size": 0, "blocks": 0, "blocks_avail": 0, "blocks_free": 0, "bytes_total": 0, "bytes_used": 0, "created_at": "string", "encrypted": true, "fstype": "string", "host_status": "ok", "id": "string", "name": "string", "region": "string", "size_gb": 0, "snapshot_retention": 0, "state": "string", "type": "local", "updated_at": "string", "zone": "string" } ]}List All Machines GET
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 Placements POST
Simulates placing the specified number of machines into regions, depending on available capacity and limits.