---
title: "Bootstrap if needed, then the first due prompt"
method: POST
path: "/agent/session/start"
---

# Bootstrap if needed, then the first due prompt

`POST /agent/session/start`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/agent/session/start`
- Auth: one of:
  - none
  - HTTP bearer
  - HTTP dpop

Write when no bearer is sent (creates an account). Read when a bearer is sent (does not mint another token). A wrong bearer is 401 and does not create an account. Returns the due queue ordered learning, then review, then new, and the first prompt. Prompts only. No answer.

## Request body

- object
  - `label` string, nullable
  - `deckId` string, uuid, nullable
  - `asOf` string, nullable: UTC ISO-8601 timestamp ending in Z
  - `limit` integer
  - `newCardMode` 'daily' | 'extra'
  - `extraNew` integer

## Response `200`

Markdown session for an existing bearer. No new token.

## Other responses

- `201`: Markdown session with a fenced token. No bearer was sent, so an account was created.
- `400`: Invalid JSON or fields.
- `401`: Missing or wrong 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)