---
title: "Ask the assistant to explain a card, or to suggest a clearer rewrite"
method: POST
path: "/revise/cards/{id}/assist"
tags: ["revise"]
---

# Ask the assistant to explain a card, or to suggest a clearer rewrite

`POST /revise/cards/{id}/assist`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/revise/cards/{id}/assist`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- ReviseAssistDto
  - `reasoning_effort` 'low' | 'high'
  - `mode` 'explain' | 'rewrite', required
  - `message` string
  - `history` ReviseAssistTurnDto[]
    - `role` 'user' | 'assistant', required
    - `content` string, required

## Response `200`

- ReviseAssistResponseDto
  - `reply` string, required
  - `suggestion` ReviseCardSuggestionDto, required
    - `front` string, required
    - `back` string, required
    - `mnemonic` ReviseMnemonicDto
      - `type` 'acronym' | 'acrostic' | 'association' | 'rhyme' | 'chunking', required
      - `text` string, required: The acronym, the acrostic sentence, or the association, rhyme or chunking
      - `expansion` string[], required: What an acronym or acrostic encodes, in letter order; empty otherwise
      - `reordered` boolean, required: The items were rearranged to make the word because their order does not matter
      - `is_english_word` boolean, nullable, required: Acronyms: the letters spell a common English word
      - `hook` string, required: The line shown under the answer, in the card's language

## Other responses

- `422`: REVISE_GENERATION_FAILED: the model failed or found nothing to learn

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)