---
title: "Post Battlecard Event"
method: POST
path: "/api/events/battlecard"
tags: ["preop-retier"]
---

# Post Battlecard Event

`POST /api/events/battlecard`

## Request

- Base URL: `https://app.archangelhealth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.archangelhealth.ai/api/events/battlecard`
- Auth: none declared

Record a battle-card view event, dedupe within 30 minutes for
the patient, then trigger a re-tier.

Pass-4: patient-session only — same rationale as `/api/events/preop-video`.

## Headers

- `authorization` string, nullable

## Request body

- BattleCardEvent
  - `episode_id` string, required
  - `dwell_ms` integer
  - `scroll_depth_pct` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform.md) - [All operations](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/archangelhealth/apis/archangel-health-surgical-patient-platform/revisions/3514f4e119da?raw)