---
title: "Restore a retired card"
method: POST
path: "/cards/{cardId}/unretire"
---

# Restore a retired card

`POST /cards/{cardId}/unretire`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/cards/{cardId}/unretire`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Write. Clear retiredAt on a card this token owns. Body may be {}. CardSchedule and past reviews stay, so dueAt and learning or review state are the ones the card had when it was retired. listDue can return the card again when it is due. A call on a card that is not retired returns retiredAt null and alreadyActive true. A retired card in an archived deck is 404 until that deck is unarchived, the same gate retire uses. There is no idempotency key. Another token's card is 404. Inventory with includeRetired=true to find the cardId.

## Path parameters

- `cardId` string, uuid, required

## Request body

- object

## Response `200`

The card is active again.

- object
  - `cardId` string, uuid, required
  - `retiredAt` unknown, required
  - `alreadyActive` boolean, required

## Other responses

- `401`: Missing or wrong token.
- `404`: No card with that id for this token, or the card is retired inside an archived deck.

---

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