---
title: "Create a bookmark (idempotent)"
method: POST
path: "/me/bookmarks"
tags: ["Bookmarks"]
---

# Create a bookmark (idempotent)

`POST /me/bookmarks`

Pass any paragraph reference format. If already bookmarked, updates the category and returns 200.

## Request body

- object
  - `ref` string, required — Paragraph reference in any format: globalId (1:2.0.1), standardReferenceId (2:0.1), or paperSectionParagraphId (2.0.1)
  - `category` string

## Response `200`

Bookmark already exists (updated category if provided)

- object
  - `data` object, required
    - `id` string, uuid, required
    - `category` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `paragraph` object, required
      - `id` string, required
      - `standardReferenceId` string, required
      - `sortId` string, required
      - `paperId` string, required
      - `sectionId` string, nullable, required
      - `partId` string, required
      - `paperTitle` string, required
      - `sectionTitle` string, nullable, required
      - `paragraphId` string, required
      - `text` string, required
      - `htmlText` string, required
      - `language` string
      - `labels` string[], nullable, required
      - `audio` object, nullable, required
      - `entities` object[]
        - `id` string, required
        - `name` string, required
        - `type` 'being' | 'place' | 'order' | 'race' | 'religion' | 'concept', required
      - `bibleParallels` object[]
        - `chunkId` string, required
        - `reference` string, required
        - `bookCode` string, required
        - `chapter` integer, required
        - `verseStart` integer, required
        - `verseEnd` integer, required
        - `text` string, required
        - `similarity` number, required
        - `rank` integer, required
        - `source` string, required
        - `embeddingModel` string, required
      - `urantiaParallels` object[]
        - `id` string, required
        - `standardReferenceId` string, required
        - `paperId` string, required
        - `paperTitle` string, required
        - `sectionTitle` string, nullable, required
        - `text` string, required
        - `similarity` number, required
        - `rank` integer, required
        - `source` string, required
        - `embeddingModel` string, required

## Other responses

- `201` — Bookmark created
- `401` — Authentication required
- `404` — Paragraph not found

---

[API](https://skmtc.dev/urantia/apis/urantia-papers-api.md) · [All operations](https://skmtc.dev/urantia/apis/urantia-papers-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/urantia/urantia-papers-api/revisions/6a8c13929fda/schema)