List jobs
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/jobs"
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}/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"id": "job_019a5e2c7b417c3e9f204d8e1a6b5c38",
"number": 1,
"session_id": "default",
"command": "sleep 30",
"cwd": "/",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"group": 42,
"pid": 42,
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null
}
]
}Jobs
List jobs
GET
/
v1
/
workspaces
/
{workspace_id}
/
jobs
List jobs
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id}/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}/jobs"
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}/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"id": "job_019a5e2c7b417c3e9f204d8e1a6b5c38",
"number": 1,
"session_id": "default",
"command": "sleep 30",
"cwd": "/",
"line_id": "line_019a5e2c-7b41-7c3e-9f20-4d8e1a6b5c37",
"group": 42,
"pid": 42,
"state": "running",
"started_at": "2026-11-07T00:00:00.000Z",
"ended_at": null,
"exit": null,
"signal": null
}
]
}List jobs tracked by workspace sessions. Filter by session, state, or command execution.
Completed jobs remain available until the session removes them. Running
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
wait or jobs can remove completed jobs after reporting them. 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). |