info:
  name: Create Highlight
  type: http
  seq: 1

http:
  method: POST
  url: '{{base_url}}/api/media-items/{{media_item_id}}/highlights'
  auth: inherit
  body:
    type: json
    data: |-
      {
        "selection_text": "Highlighted text...",
        "start_position": "epubcfi(/6/4/2:15)",
        "end_position": "epubcfi(/6/4/2:20)",
        "color": "#ffff00",
        "percentage_start": 0.45,
        "percentage_end": 0.47
      }
settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5

runtime:
  scripts:
    - type: tests
      code: |-
        test("status is 201", function() {
          expect(res.status).to.eql(201);
        });

docs:
  content: |-
    # Create Highlight

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

    Canonical reference: docs/developer/api/highlights/create_highlight.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