info:
  name: Create Media Bookmark
  type: http
  seq: 3

http:
  method: POST
  url: '{{base_url}}/api/media-items/{{media_item_id}}/bookmarks'
  auth: inherit
  body:
    type: json
    data: |-
      {
        "title": "Chapter 3",
        "position": "kindle:pos:1:2",
        "notes": "revisit this",
        "cfi_position": "epubcfi(/6/4)",
        "page_number": 42,
        "chapter_number": 3,
        "percentage": 35.5,
        "chapter_reference": 3,
        "origin": "android"
      }
settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5

docs:
  content: |-
    # Create Media Bookmark

    `POST /api/media-items/:id/bookmarks` — auth: jwt.

    Canonical reference: docs/developer/api/media-items/create_media_bookmark.md (docs site → Developer → API). This request is GENERATED from that doc; edit the doc, then run the drift test with -update.
  type: text/markdown