Get machine
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"type": "host",
"name": "my-laptop",
"id": "my-laptop",
"state": "managed",
"checked_at": "2026-11-07T00:00:05.000Z",
"processes": [
{
"pid": 4194305,
"session_id": "agent",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 4194305,
"command": "rm /notes.txt",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": null,
"state": "exited",
"started_at": "2026-11-07T00:00:04.000Z",
"ended_at": "2026-11-07T00:00:04.008Z",
"exit": 126,
"signal": null,
"error": null
}
]
}Machines
Get machine
GET
/
v1
/
workspaces
/
{workspace_id}
/
machines
/
{machine}
Get machine
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}/machines/{machine}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"type": "host",
"name": "my-laptop",
"id": "my-laptop",
"state": "managed",
"checked_at": "2026-11-07T00:00:05.000Z",
"processes": [
{
"pid": 4194305,
"session_id": "agent",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 4194305,
"command": "rm /notes.txt",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": null,
"state": "exited",
"started_at": "2026-11-07T00:00:04.000Z",
"ended_at": "2026-11-07T00:00:04.008Z",
"exit": 126,
"signal": null,
"error": null
}
]
}Get machine status and the tracked processes found on it. The machine is checked when requested.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
Errors
Errors
| Status | Meaning |
|---|---|
400 | The request is malformed: the body is not JSON (invalid_json) or not a JSON object, a field is missing (missing_field), unknown (unknown_field) or has a wrong value (invalid_value), or the request is otherwise invalid (invalid_request). param names the field at fault. |
401 | The token is missing or wrong (unauthorized). |
404 | The workspace, session, job, file or route does not exist, or the caller may not see it (not_found). |
429 | Past a rate limit (rate_limited), or a new session past max_sessions (session_limit). |
Authorizations
Path Parameters
Response
200 - application/json
OK