Wait for State
Wait for a Machine to reach a specific state. Specify the desired state with the state parameter. See the [Machine states table](https://fly.io/docs/machines/working-with-machines/#machine-states) for a list of possible states. The default for this parameter is `started`. This request will block for up to 60 seconds. Set a shorter timeout with the timeout parameter.
Wait for a Machine to reach a specific state. Specify the desired state with the state parameter. See the Machine states table for a list of possible states. The default for this parameter is started.
This request will block for up to 60 seconds. Set a shorter timeout with the timeout parameter.
Authorization
bearerAuth A Fly.io access token. Create one with fly tokens create.
In: header
Path Parameters
Fly App Name
Machine ID
Query Parameters
26-character Machine version ID
26-character Machine version ID (deprecated; use version)
26-character Machine event ID to start waiting after
wait timeout. default 60s
desired state(s), supports repeated or comma-separated values
Response Body
application/json
application/json
curl -X GET "https://example.com/apps/string/machines/string/wait"{ "event_id": "string", "ok": true, "state": "string", "version": "string"}{ "details": {}, "error": "string", "status": "unknown"}