Sign in
Machines

List Machines

Changed on

Returns active Machines in the caller's current workspace in descending ID order. Machine root filesystems are ephemeral, so filesystem changes are lost whenever execution stops or restarts.

get/machines

Request

  • Base URL: /v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/machines
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of Machines to return. Defaults to 50 and cannot exceed 100.

afterstring

Return resources after this cursor. Use meta.cursor_end from the previous page.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "/v1/schemas/CursorListResponseMachineResponse.json",
  "data": [
    {
      "$schema": "/v1/schemas/MachineResponse.json",
      "network": {
        "ingress": {
          "authenticated": {
            "key": "atlasflow",
            "ports": [
              "80",
              "443"
            ]
          },
          "public": {
            "ports": [
              "0-65535"
            ]
          }
        }
      }
    }
  ]
}

Changes