---
title: "Rename, re-point, move or reorder a bookmark or folder"
method: PATCH
path: "/browser-bookmarks/{id}"
tags: ["browser-bookmarks"]
---

# Rename, re-point, move or reorder a bookmark or folder

`PATCH /browser-bookmarks/{id}`

## 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/browser-bookmarks/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateBrowserBookmarkDto
  - `title` string: May be empty, as in Chrome. Stored encrypted.
  - `url` string: Required for a bookmark, rejected for a folder. Any scheme. Stored encrypted.
  - `parent_id` string, uuid, nullable: Move into this folder; null moves to the top level, omitted leaves it where it is
  - `position` number: New sort key among siblings

## Response `200`

- BrowserBookmarkResponseDto
  - `id` string, uuid, required
  - `parent_id` string, uuid, nullable, required: Null for a top-level item
  - `kind` 'bookmark' | 'folder', required
  - `client_id` string, nullable, required
  - `title` string, required
  - `url` string, nullable, required: Null exactly when kind is folder
  - `position` number, required: Sort key among siblings; order by position, then id
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable, required: Set on a deleted item; only the sync feed returns deleted items

## Other responses

- `400`: Body is { code, message }; code is one of: browser_bookmark_url_not_allowed_on_folder
- `404`: No live bookmark or folder with this id belongs to the caller
- `409`: Body is { code, message }; code is one of: browser_bookmark_parent_not_found, browser_bookmark_parent_not_folder, browser_bookmark_move_into_descendant

---

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