---
title: "Reorder pending prompt jobs"
method: POST
path: "/session/{sessionID}/queue/reorder"
---

# Reorder pending prompt jobs

`POST /session/{sessionID}/queue/reorder`

Rewrite the run order for the session's pending jobs. Caller passes the complete intended order; running / completed / failed / cancelled rows are not allowed in the input. Returns the affected jobs in their new order.

## Path parameters

- `sessionID` string, required

## Query parameters

- `directory` string
- `workspace` string

## Request body

- object
  - `jobIDs` string[], required

## Response `200`

Reordered 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
- `409` — Conflict

---

[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)