v1

latestOpenAPI 3.1.02026-07-22136108233.0 KB

machines

Update Machine Pools

Update a machine's pool assignments. This replaces all existing pool assignments with the new ones.

put/v1/machines/{machine_id}/pools

Path parameters

machine_idstring uuid required

Headers

Idempotency-Keystring

Example:550e8400-e29b-41d4-a716-446655440000

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Request body

pool_idsstring[] required

List of pool IDs to assign the machine to

Response

Successful Response

namestring nullable

versionstring nullable

hostnamestring nullable

os_infostring nullable

machine_parametersobject nullable

Machine-specific input values that auto-populate runs

machine_sensitive_parametersobject nullable

Machine-specific sensitive input aliases (stored in Basis Theory)

idstring uuid required

user_idstring uuid nullable

organization_idstring nullable

unkey_key_idstring required

status'connected' | 'disconnected' | 'error' required

is_availableboolean required

alerts_enabledboolean required

reserved_session_idstring uuid nullable

linked_keepalive_machine_idstring uuid nullable

physical_server_idstring nullable

Fly machine ID hosting the WebSocket connection

created_atstring date-time required

last_seenstring date-time required