---
title: "List sessions"
method: GET
path: "/api/projects/{projectId}/sessions/"
tags: ["Sessions"]
---

# List sessions

`GET /api/projects/{projectId}/sessions/`

List sessions. Returns the requested resource or collection for the authenticated caller.

## Path parameters

- `projectId` string, required

## Response `200`

Sessions

- SessionsResponse — sessions Response payload returned by the API.
  - `sessions` Session[], required — Collection of session values.
    - `id` string, required — Stable identifier for the object.
    - `projectId` string, required — Project identifier that owns or scopes this object.
    - `workspaceId` string, required — Workspace identifier associated with this object.
    - `providerId` string — Sandbox provider identifier.
    - `name` string, required — Human-readable name.
    - `displayName` string, nullable — Optional display name shown to users.
    - `description` string, nullable — Optional human-readable description.
    - `sandboxStatus` string, required — Collection of sandbox statu values.
    - `sandboxStatusMessage` string, nullable — sandbox Status Message value for the session object.
    - `threadStatus` SessionThreadStatus — session Thread Status API object.
      - `status` string, required — Current status value.
      - `reason` string — reason value for the session Thread Status object.
      - `needsAttentionCount` integer — needs Attention Count value for the session Thread Status object.
      - `runningCount` integer — running Count value for the session Thread Status object.
      - `queuedCount` integer — queued Count value for the session Thread Status object.
      - `unknownCount` integer — unknown Count value for the session Thread Status object.
      - `threadId` string — Thread identifier associated with this object.
      - `updatedAt` string — Time when the object was last updated.
    - `commitStatus` string, required — Collection of commit statu values.
    - `commitOperation` string, nullable — commit Operation value for the session object.
    - `commitError` string, nullable — commit Error value for the session object.
    - `targetRef` string, nullable — target Ref value for the session object.
    - `appliedCommit` string, nullable — applied Commit value for the session object.
    - `errorMessage` string, nullable — Detailed error message, when present.
    - `workspacePath` string, nullable — workspace Path value for the session object.
    - `createdAt` string, date-time, required — Time when the object was created.
    - `updatedAt` string, date-time, required — Time when the object was last updated.

---

[API](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api.md) · [All operations](https://skmtc.dev/ibuildthecloud/apis/discobot-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibuildthecloud/discobot-server-api/revisions/4de3fcd6be56/schema)