---
title: "Persist a manual reorder of the queue. Body provides the desired
top-to-bottom order of appointment ids."
method: PATCH
path: "/CareQueue/reorder"
tags: ["CareQueue"]
---

# Persist a manual reorder of the queue. Body provides the desired
top-to-bottom order of appointment ids.

`PATCH /CareQueue/reorder`

## Query parameters

- `date` string, date-time

## Request body

- CareQueueReorderRequest — Request body for PATCH /carequeue/reorder. Provides the full target order.
  - `orderedAppointmentIds` string[] — AppointmentIds in the desired order (top of queue first). Server persists `queue_position` from the index.

## Response `200`

OK

- CareQueueStateDto — Complete CareQueue state — the FIFO triage queue board state for a clinic on a given day. Sits upstream of the Flowboard: once a patient is roomed, they leave CareQueue and appear on the Flowboard. See ITE-58.
  - `entries` CareQueueEntryDto[]
    - `id` string — Unique queue entry id (mirrors AppointmentId for v1).
    - `appointmentId` string
    - `patientId` string, nullable
    - `patientName` string
    - `species` string, nullable
    - `clientId` string
    - `clientName` string
    - `acuity` union — Triage acuity 1–10. Higher = more urgent.
      - integer
      - string, int32
    - `status` string — "triaged" | "waiting" | "roomed".
    - `etaRangeMinutes` string — Display range, e.g. "10–15". Computed from provider state.
    - `enteredAt` string, date-time — ISO timestamp when the entry was added (check-in time for v1).
    - `issue` string — Reason for visit / presenting issue.
    - `notes` string, nullable — Free-form triage notes.
    - `queuePosition` union — Persisted manual ordering; lower = earlier in queue.
      - integer
      - string, int32
  - `providers` CareQueueProviderDto[]
    - `id` string
    - `name` string
    - `role` string — Display role, e.g. "DVM (Surgery)", "LVT".
    - `status` string — "critical" | "busy" | "available".
    - `complexity` string — "High" | "Med" | "Low" | "None".
    - `interruptibility` union — 0–100. How interruptible the provider is right now.
      - integer
      - string, int32
    - `timeToCapacity` string — Display string, e.g. "~10–15m" or "Immediate" or "Unknown".
    - `currentCases` string[] — Display labels for active cases (patient + reason).
  - `events` CareQueueEventDto[]
    - `time` string, date-time
    - `type` string — Dotted event type, e.g. "queue.entry.acuity_updated".
    - `msg` string
    - `critical` boolean
  - `timestamp` string, date-time

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/d8d7501dde48/schema)