Skip to main content
GET
/
api
/
v0
/
computers
/
name
/
{name}
Get a computer by name
curl --request GET \
  --url https://api.factory.ai/api/v0/computers/name/{name} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "providerType": "byom",
  "createdAt": 123,
  "hostname": "<string>",
  "status": "provisioning",
  "provisioningSteps": [
    {
      "id": "create-computer",
      "name": "<string>",
      "status": "pending",
      "error": "<string>",
      "startedAt": 123,
      "completedAt": 123
    }
  ],
  "relayClientUrl": "<string>",
  "relayAgentUrl": "<string>"
}

Authorizations

Authorization
string
header
required

Factory API key or JWT token for authentication

Path Parameters

name
string
required

Computer name

Required string length: 1 - 63

Response

Response for status 200

id
string
required
name
string
required
providerType
enum<string>
required
Available options:
byom,
e2b
createdAt
number
required
hostname
string
status
enum<string>
Available options:
provisioning,
active,
error
provisioningSteps
object[]
relayClientUrl
string<uri>
relayAgentUrl
string<uri>