Droid Computers API
Provision and manage Factory computers: create, inspect, refresh, restart, and delete.
List computers
Returns all persistent computer environments for the authenticated organization.
curl 'https://api.factory.ai/api/v0/computers' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Whether to include provisioning step details.
Allowed values
Responses
Allowed values
Allowed values
Allowed values
Allowed values
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Create a computer
Creates a new persistent computer environment.
curl -X POST 'https://api.factory.ai/api/v0/computers' \
-H 'Authorization: Bearer $FACTORY_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ ... }'Request body
Allowed values
Allowed values
Allowed values
Responses
Allowed values
Allowed values
Allowed values
Allowed values
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
402Response for status 402
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Get a computer by name
Returns details about a specific computer by name.
curl 'https://api.factory.ai/api/v0/computers/name/{name}' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer name
Responses
Allowed values
Allowed values
Allowed values
Allowed values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Get a computer
Returns details about a specific computer by ID.
curl 'https://api.factory.ai/api/v0/computers/{computerId}' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Responses
Allowed values
Allowed values
Allowed values
Allowed values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Delete a computer
Terminal deletion: sets `deletedAt`, revokes the API key, archives sessions, and tears down provider resources for managed computers. Cannot be undone.
curl -X DELETE 'https://api.factory.ai/api/v0/computers/{computerId}' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Responses
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Update a computer
Updates a computer by ID.
curl -X PATCH 'https://api.factory.ai/api/v0/computers/{computerId}' \
-H 'Authorization: Bearer $FACTORY_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ ... }'Parameters
Computer ID
Request body
Responses
Allowed values
Allowed values
Allowed values
Allowed values
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
409Response for status 409
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Retry the install-dependencies step
Resets the install-deps provisioning step to Running and spawns a fresh install session. No-op (409) if a session is already running.
curl -X POST 'https://api.factory.ai/api/v0/computers/{computerId}/install-deps' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Responses
Allowed values
Allowed values
Allowed values
Allowed values
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
409Response for status 409
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Get computer metrics
Returns CPU, memory, and disk usage metrics for an active E2B computer.
curl 'https://api.factory.ai/api/v0/computers/{computerId}/metrics' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Start of time range (ISO 8601)
Responses
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
503Response for status 503
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Refresh a computer
Refreshes a computer by re-configuring credentials and environment. Currently configures git credentials for all connected SCM integrations.
curl -X POST 'https://api.factory.ai/api/v0/computers/{computerId}/refresh' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Responses
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
Restart a managed computer
Resumes a paused managed sandbox. No-op if the sandbox is already running.
curl -X POST 'https://api.factory.ai/api/v0/computers/{computerId}/restart' \
-H 'Authorization: Bearer $FACTORY_API_KEY'Parameters
Computer ID
Responses
400Response for status 400
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
401Response for status 401
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
402Response for status 402
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
403Response for status 403
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
404Response for status 404
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values
500Response for status 500
Human-readable error message
HTTP status code
HTTP status title
Additional error metadata
Values