---
title: "List queued prompt jobs"
method: GET
path: "/session/{sessionID}/queue"
---

# List queued prompt jobs

`GET /session/{sessionID}/queue`

Snapshot of the per-session prompt queue. Returns jobs in run order (sort_order first, then id). Use this on first paint; subscribe to the SSE stream's session.queue.* events for live updates.

## Path parameters

- `sessionID` string, required

## Query parameters

- `directory` string
- `workspace` string
- `all` boolean

## Response `200`

List of jobs

- object[]
  - `id` string, required
  - `sessionID` string, required
  - `directory` string, required
  - `payload` string, required
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `attempt` number, required
  - `maxAttempts` number, required
  - `nextRunAt` number
  - `timeStarted` number
  - `timeCompleted` number
  - `errorMessage` string
  - `sortOrder` number
  - `timeCreated` number, required
  - `timeUpdated` number, required

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.dev/isogonic/apis/codeplane.md) · [All operations](https://skmtc.dev/isogonic/apis/codeplane/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/isogonic/codeplane/revisions/e787ab2e6692/schema)