> ## Documentation Index
> Fetch the complete documentation index at: https://isol8.notdhruv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List sessions

> Return all active persistent sessions with their status and last-accessed timestamp.

Returns an array of every persistent session currently tracked by the server.

<ResponseField name="sessions" type="SessionInfo[]">
  Array of session objects.

  <Expandable title="SessionInfo">
    <ResponseField name="id" type="string">
      Session identifier (user-provided or auto-generated).
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      Whether the session's engine is currently started.
    </ResponseField>

    <ResponseField name="lastAccessedAt" type="string">
      ISO 8601 timestamp of the last execution or file operation.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl http://localhost:3000/sessions \
    -H "Authorization: Bearer $ISOL8_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "sessions": [
      {
        "id": "my-session",
        "isActive": true,
        "lastAccessedAt": "2025-06-15T12:34:56.789Z"
      },
      {
        "id": "cli-1718451234567",
        "isActive": true,
        "lastAccessedAt": "2025-06-15T12:30:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  Sessions that were destroyed via `DELETE /session/:id` no longer appear in this list.
</Note>