---
title: "Leniently check whether a to-do task supports the focus intention. Only flags clear conflicts so the client can prompt the user to reconcile (backend#2340); fails open to aligns=true on any AI error."
method: POST
path: "/user/task-intention-check"
tags: ["user"]
---

# Leniently check whether a to-do task supports the focus intention. Only flags clear conflicts so the client can prompt the user to reconcile (backend#2340); fails open to aligns=true on any AI error.

`POST /user/task-intention-check`

## 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/user/task-intention-check`
- Auth: HTTP bearer

## Request body

- TaskIntentionCheckDto
  - `intention` string, required: The focus intention the user set for this session.
  - `task_name` string, required: The name of the task the user is (or is about to be) working on.
  - `focus_mode` string: Optional focus mode name for extra context.

## Response `200`

- TaskIntentionCheckResponseDto
  - `aligns` boolean, required: Whether the task supports the focus intention. Lenient: true unless clearly conflicting.
  - `reason` string, required: Short, kind, user-facing sentence localised to the user's language. When aligns=false it names both the intention and the task; when aligns=true it may be a brief confirmation or empty.

---

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