---
title: "Consume Asclepius Portal Handoff"
method: POST
path: "/api/asclepius/auth/portal-handoff/consume"
tags: ["asclepius"]
---

# Consume Asclepius Portal Handoff

`POST /api/asclepius/auth/portal-handoff/consume`

## 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/asclepius/auth/portal-handoff/consume`
- Auth: none declared

## Request body

- AscPortalHandoffConsumeRequest: Trade a short-lived handoff code (minted by POST /auth/portal-handoff) for the Asclepius session token it was issued for — see main.py's doctor-portal handoff for the pattern this mirrors.
  - `handoff_code` string, required

## Response `200`

Successful Response

- unknown

## 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)