List workspaces
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"id": "demo",
"status": "running",
"created_at": "2026-11-07T00:00:00.000Z"
},
{
"id": "notes",
"status": "stopped",
"created_at": "2026-11-06T00:00:00.000Z"
}
]
}Lifecycle
List workspaces
GET
/
v1
/
workspaces
List workspaces
curl --request GET \
--url http://127.0.0.1:8765/v1/workspaces \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces"
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', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"id": "demo",
"status": "running",
"created_at": "2026-11-07T00:00:00.000Z"
},
{
"id": "notes",
"status": "stopped",
"created_at": "2026-11-06T00:00:00.000Z"
}
]
}Running workspaces first, then stopped ones, which keep only their config and state until a start.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
Errors
Errors
| Status | Meaning |
|---|---|
401 | The token is missing or wrong (unauthorized). |
429 | Past a rate limit (rate_limited), or a new session past max_sessions (session_limit). |