---
search:
  tags:
    - Bookmarks
    - PATCH
seo:
  description: >-
    Partially update a bookmark. Set collection_id to an empty string to remove
    the… Reference for the PATCH /v1/bookmarks/{id} endpoint in the Webfold API.
sidebar:
  label: Update a bookmark
  badge: PATCH
title: Update a bookmark
type: openapi-operation
---
Partially update a bookmark. Set `collection_id` to an empty string to
remove the bookmark from its collection.

`PATCH /v1/bookmarks/{id}`

**Request body** (`application/json`, required)

- `title` (string)
- `description` (string)
- `tags` (string[])
- `collection_id` (string) — Existing collection ID. Pass an empty string to remove from the current collection.

Request body example:

```json
{
  "title": "string",
  "description": "string",
  "tags": [
    "string"
  ],
  "collection_id": "string"
}
```

**Responses**

- `200` — Updated bookmark
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `404` — Resource not found

Response example, 200:

```json
{
  "id": "bkm_1",
  "url": "https://example.com",
  "title": "Example",
  "description": "An example page",
  "tags": [
    "demo"
  ],
  "collection_id": "col_1",
  "owner": "dev",
  "archived_content": "string",
  "archived_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}
```