List PTY sessions
List PTY sessions for a location, including exited sessions retained until removal.
GET
/api/ptyQuery parameters
locationobject | anyResponses
200Success
locationLocation.InforequiredShow propertiesHide properties
directorystringrequiredworkspaceIDobjectShow propertiesHide properties
objectprojectobjectrequiredShow propertiesHide properties
idstringrequireddirectorystringrequireddataPty[]requiredShow propertiesHide properties
Array of
PtyidobjectrequiredShow propertiesHide properties
objecttitlestringrequiredcommandstringrequiredargsstring[]requiredcwdstringrequiredstatusstringrequiredAllowed:
runningexitedpidobjectrequiredShow propertiesHide properties
objectexitCodeobjectShow propertiesHide properties
object400InvalidRequestError
_tagstringrequiredAllowed:
InvalidRequestErrormessagestringrequiredkindstring | anyShow propertiesHide properties
Any of:
string
stringany
anyfieldstring | anyShow propertiesHide properties
Any of:
string
stringany
any401UnauthorizedError
_tagstringrequiredAllowed:
UnauthorizedErrormessagestringrequiredRequest
curl -X GET "/api/pty"const response = await fetch("/api/pty", {
method: "GET"
});import requests
response = requests.get(
"/api/pty",
)Response
{
"location": {
"directory": "string",
"workspaceID": {},
"project": {
"id": "string",
"directory": "string"
}
},
"data": [
{
"id": {},
"title": "string",
"command": "string",
"args": [
"string"
],
"cwd": "string",
"status": "running",
"pid": {},
"exitCode": {}
}
]
}{
"_tag": "InvalidRequestError",
"message": "string",
"kind": "string",
"field": "string"
}{
"_tag": "UnauthorizedError",
"message": "string"
}