StudioHomepage
ServicesWorker PoolsHTTP APIWorker sessions

List worker sessions

GET
/api/tasks/projects/{project_id}/worker-sessions

List Worker sessions by descending session ID. Pages default to 100 items with a maximum of 1000. Continuations expire after one hour and are scoped to the caller, target, operation, filters and page size. This is a live listing; concurrent updates can change later pages.

This operation returns results in pages. To get the next page, send the nextPageToken value of the response as pageToken in a new request with the same parameters. When the response has no nextPageToken, there are no more pages. A page can have an empty workerSessions list before the last page.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Path Parameters

project_id*string

Query Parameters

pageSize?|null
pageToken?string|null
status?|null
workerPoolId?|null

Response Body

Success

application/json
  1. response
nextPageToken?string|null
workerSessions*array<>
curl -X GET 'https://api.spiraldb.dev/api/tasks/projects/string/worker-sessions'
{  "nextPageToken": "string",  "workerSessions": [    {      "capabilities": {        "architecture": "string",        "installedTaskSpecs": [          {            "name": "string",            "version": 0          }        ],        "operatingSystem": "string",        "resources": {          "cpuCount": 0,          "gpu": {            "count": 0,            "memoryBytes": "string",            "runtime": "cuda"          },          "memoryBytes": "string"        }      },      "createdAtMicros": "string",      "currentAttemptId": "3115e16a-ac06-4092-bb8d-8419fb0229bb",      "identity": {        "type": "user",        "user": {          "userId": "string"        }      },      "lastHeartbeatAtMicros": "string",      "processInstanceId": "e208d7c6-f7e3-44cc-bbfb-74c86607a4b7",      "projectId": "string",      "releaseVersion": "string",      "resourceUsage": {        "cpuObservedMicros": "string",        "cpuTimeMicros": "string",        "latest": {          "cpuLimitMillicores": "string",          "cpuTimeMicros": "string",          "durationMicros": "string",          "memoryBytes": "string",          "memoryLimitBytes": "string",          "observedAtMicros": "string",          "peakMemoryBytes": "string",          "sequence": "string",          "source": "cgroup"        },        "peakMemoryBytes": "string",        "receivedAtMicros": "string"      },      "status": "active",      "tags": {        "property1": "string",        "property2": "string"      },      "updatedAtMicros": "string",      "workerPoolId": "e466ab52-fe40-49dd-8e6c-d197c33239a3",      "workerSessionId": "152a40cf-919e-487a-8d16-020853a46015"    }  ]}