---
title: "POST /focus-mode/{focus_mode_id}/start"
method: POST
path: "/focus-mode/{focus_mode_id}/start"
tags: ["focus-mode"]
---

# POST /focus-mode/{focus_mode_id}/start

`POST /focus-mode/{focus_mode_id}/start`

## 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/focus-mode/{focus_mode_id}/start`
- Auth: HTTP bearer

## Path parameters

- `focus_mode_id` string, uuid, required

## Request body

- StartFocusModeDto
  - `intention` string
  - `finish_time` string, date-time, required
  - `start_time` string, date-time, required
  - `to_do_ids` string[]
  - `to_dos` object[]
    - `id` string
  - `block_level` 'gentle' | 'strict' | 'super-strict'

## Response `201`

- ResponseMessage
  - `message` string, required
  - `success` boolean, required
  - `timestamp` string, date-time, required
  - `statusCode` number

---

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