Delete workspace
curl --request DELETE \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HTTP/1.1 204 No Content
Lifecycle
Delete workspace
DELETE
/
v1
/
workspaces
/
{workspace_id}
Delete workspace
curl --request DELETE \
--url http://127.0.0.1:8765/v1/workspaces/{workspace_id} \
--header 'Authorization: Bearer <token>'import requests
url = "http://127.0.0.1:8765/v1/workspaces/{workspace_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('http://127.0.0.1:8765/v1/workspaces/{workspace_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HTTP/1.1 204 No Content
Stop the workspace and delete its saved state. Files in external storage are not deleted.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
HTTP/1.1 204 No Content
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). |
409 | The request conflicts with the current state. The id or name is taken (already_exists), the workspace is busy on another server or starting or stopping (workspace_busy), the workspace is stopped (workspace_stopped), a file changed since it was read (stale_write), or the state allows no such change (conflict). |
429 | Past a rate limit (rate_limited), or a new session past max_sessions (session_limit). |
500 | The server failed internally (internal). The message is internal server error and the cause goes to the server log. A file call that fails with an I/O error (EIO, EPIPE, EBADF) carries its errno and the POSIX message instead. Check for side effects before retrying. |