Get command
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/lines/{line_id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/lines/{line_id}"
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}/lines/{line_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"session_id": "default",
"command": "sleep 30 & wait",
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"jobs": [
"job_019a5e2c7b417c3e9f204d8e1a6b5c38"
],
"processes": [
{
"pid": 41,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 41,
"command": "sleep 30 & wait",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": null,
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"children": [
{
"pid": 42,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": 41,
"group": 41,
"command": "sleep 30",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": {
"pid": 12345,
"started": 1794009600,
"exited": null
},
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"children": []
}
]
}
]
}Commands
Get command
GET
/
v1
/
workspaces
/
{workspace_id}
/
lines
/
{line_id}
Get command
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/lines/{line_id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/lines/{line_id}"
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}/lines/{line_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"session_id": "default",
"command": "sleep 30 & wait",
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"jobs": [
"job_019a5e2c7b417c3e9f204d8e1a6b5c38"
],
"processes": [
{
"pid": 41,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 41,
"command": "sleep 30 & wait",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": null,
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"children": [
{
"pid": 42,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": 41,
"group": 41,
"command": "sleep 30",
"cwd": "/",
"machine": {
"type": "host",
"name": "my-laptop",
"id": "my-laptop"
},
"machine_pid": {
"pid": 12345,
"started": 1794009600,
"exited": null
},
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null,
"error": null,
"children": []
}
]
}
]
}Get a command execution with its job IDs and the processes it ran, each under the one that started it and naming the machine it ran on. Use the
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
line_id returned by the shell endpoint.
Completed commands are retained for up to one hour, with a maximum of 1,024 records. Servers sharing a workspace store share these records; snapshots preserve completed records. Times are RFC 3339 strings in UTC.
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