---
title: "List prompts for edit or retire"
method: POST
path: "/agent/decks/inventory"
---

# List prompts for edit or retire

`POST /agent/decks/inventory`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/agent/decks/inventory`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Routine read. Same data as listDeckCards. Prompts only. Includes deckNote and cardNote. Order is dueAt ascending, then createdAt, then cardId. Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card). limit defaults to 50 and maxes at 200.

## Request body

- object
  - `deckId` string, uuid, required
  - `includeRetired` boolean
  - `limit` integer
  - `cursor` string

## Response `200`

Markdown inventory. Prompts only.

## Other responses

- `400`: Invalid JSON or fields.
- `401`: Missing or wrong token.
- `404`: No deck with that id for this token.

---

[API](https://skmtc.dev/fluidrecall/apis/fluid-recall.md) · [All operations](https://skmtc.dev/fluidrecall/apis/fluid-recall/llms.txt) · [OpenAPI document](https://skmtc.dev/fluidrecall/apis/fluid-recall/revisions/7bf2563c3d2a?raw)