---
title: "Change the new-card allowance"
method: PATCH
path: "/settings"
---

# Change the new-card allowance

`PATCH /settings`

## Request

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

Write. Send newCardsPerDay, timezone, dayBoundaryHour, or any combination. newCardsPerDay here changes the fallback for decks that still have null. Decks that store their own integer keep it. Prefer updateDeck when you are changing the deck you are coaching. This does not reset cards already introduced today. To study past today's cap without changing the stored number, use listDue with newCardMode=extra.

## Request body

- object
  - `newCardsPerDay` integer
  - `timezone` string
  - `dayBoundaryHour` integer

## Response `200`

The updated account study settings.

- StudySettings
  - `newCardsPerDay` integer, required: Account fallback used only when a deck's newCardsPerDay is null. A stored 20 on a new account is the legacy column default, not a coaching choice. Set the deck explicitly.
  - `timezone` string, required: IANA timezone for the study day. UTC unless changed.
  - `dayBoundaryHour` integer, required: Local hour when the study day starts. 4 means 04:00. Before that hour, the previous study day is still in effect.

## Other responses

- `400`: Invalid body.
- `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)