List processes
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/processes \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/processes"
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}/processes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"pid": 42,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 42,
"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
}
]
}Processes
List processes
GET
/
v1
/
workspaces
/
{workspace_id}
/
processes
List processes
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/processes \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/processes"
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}/processes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"pid": 42,
"session_id": "default",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"parent": null,
"group": 42,
"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
}
]
}List running and recently ended processes, ordered by process ID. Filter by session, state, command execution, job, or machine.
Ended processes are retained for up to one hour, with a maximum of 1,024 records. Servers sharing a workspace store share these records; snapshots preserve ended records. Times are RFC 3339 strings in UTC.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
Errors
Errors
| Status | Meaning |
|---|---|
400 | A query parameter is not valid (invalid_value, with param), such as an unknown state or a machine not in provider:name format. |
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). |