API reference

curl -X POST https://bumpups.com/api/v1/videos \
  -H "Authorization: Bearer $BUMPUPS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url":"https://www.youtube.com/watch?v=kBdfcR-8hEY"}'

Location: /api/v1/videos/sRV9zsGtyJRc2apg
Retry-After: 60

{
  "object": "video",
  "id": "sRV9zsGtyJRc2apg",
  "youtube_id": "kBdfcR-8hEY",
  "title": "Justice: What's The Right Thing To Do? Episode 01 \"THE MORAL SIDE OF MURDER\"",
  "duration_seconds": 3296,
  "minutes_charged": 54,
  "status": "processing",
  "chapters": null,
  "chapters_text": null,
  "error": null,
  "app_url": "https://bumpups.com/workspace/sRV9zsGtyJRc2apg",
  "created_at": "2026-10-09T20:51:39Z"
}

curl https://bumpups.com/api/v1/videos/sRV9zsGtyJRc2apg \
  -H "Authorization: Bearer $BUMPUPS_API_KEY"

{
  "object": "video",
  "id": "sRV9zsGtyJRc2apg",
  "youtube_id": "kBdfcR-8hEY",
  "title": "Justice: What's The Right Thing To Do? Episode 01 \"THE MORAL SIDE OF MURDER\"",
  "duration_seconds": 3296,
  "minutes_charged": 54,
  "status": "ready",
  "chapters": [
    {
      "start_seconds": 0,
      "timestamp": "0:00",
      "title": "Intro credits and course framing"
    },
    {
      "start_seconds": 150,
      "timestamp": "2:30",
      "title": "Audience poll: trolley dilemma choices"
    },
    {
      "start_seconds": 327,
      "timestamp": "5:27",
      "title": "Bridge variant: would you push the fat man?"
    }
  ],
  "chapters_text": "0:00 - Intro credits and course framing\n2:30 - Audience poll: trolley dilemma choices\n5:27 - Bridge variant: would you push the fat man?",
  "error": null,
  "app_url": "https://bumpups.com/workspace/sRV9zsGtyJRc2apg",
  "created_at": "2026-10-09T20:51:39Z"
}

Trimmed to the first 3 of 15 chapters.

curl -X POST https://bumpups.com/api/v1/videos/sRV9zsGtyJRc2apg/questions \
  -H "Authorization: Bearer $BUMPUPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Which cases does the professor use to test our moral intuitions?"}'

Location: /api/v1/videos/sRV9zsGtyJRc2apg/questions/kEV7Adv4Ed0RyJfI
Retry-After: 10

{
  "object": "question",
  "id": "kEV7Adv4Ed0RyJfI",
  "video_id": "sRV9zsGtyJRc2apg",
  "question": "Which cases does the professor use to test our moral intuitions?",
  "created_at": "2026-10-09T21:37:33Z",
  "status": "pending",
  "answer": null,
  "error": null
}

curl https://bumpups.com/api/v1/videos/sRV9zsGtyJRc2apg/questions/kEV7Adv4Ed0RyJfI \
  -H "Authorization: Bearer $BUMPUPS_API_KEY"

{
  "object": "question",
  "id": "kEV7Adv4Ed0RyJfI",
  "video_id": "sRV9zsGtyJRc2apg",
  "question": "Which cases does the professor use to test our moral intuitions?",
  "created_at": "2026-10-09T21:37:33Z",
  "status": "answered",
  "answer": "The professor presents five main cases to test moral intuitions:\n\n*   **The trolley car driver:** You are driving a runaway trolley and must choose between staying on the track to kill five workers or turning onto a side track to kill one.\n*   **The onlooker on the bridge:** You are watching a runaway trolley and can save five workers on the track by pushing a heavy man off a bridge to stop the trolley, killing him.\n*   **The transplant surgeon:** You have five patients who will die without organ transplants. You can save them by killing a healthy patient who came in for a checkup and harvesting his organs.",
  "error": null
}

Trimmed to the first 3 of 5 cases.

curl https://bumpups.com/api/v1/account \
  -H "Authorization: Bearer $BUMPUPS_API_KEY"

{
  "object": "account",
  "plan": "pro",
  "minutes_limit": 1000,
  "minutes_used": 67,
  "minutes_left": 933,
  "resets_at": "2026-11-01T00:00:00Z"
}