Skip to main content
GET
/
api
/
v0
/
computers
List computers
curl --request GET \
  --url https://api.factory.ai/api/v0/computers \
  --header 'Authorization: Bearer <token>'
{
  "computers": [
    {
      "id": "<string>",
      "name": "<string>",
      "createdAt": 123,
      "hostId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "hostname": "<string>",
      "provisioningSteps": [
        {
          "id": "<string>",
          "name": "<string>",
          "status": "<string>",
          "error": "<string>",
          "startedAt": 123,
          "completedAt": 123,
          "installSessionId": "<string>"
        }
      ],
      "relayClientUrl": "<string>",
      "relayAgentUrl": "<string>",
      "remoteUser": "<string>",
      "ownerPrincipalKind": "<string>",
      "ownerId": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Factory API key or JWT token for authentication

Query Parameters

​
hostId
string<uuid>
​
includeProvisioningSteps
enum<string>

Whether to include provisioning step details.

Available options:
true,
false

Response

Response for status 200

​
computers
object[]
required