---
title: "Generate Specialty Tasks"
method: POST
path: "/api/asclepius/generation/{specialty}"
tags: ["asclepius"]
---

# Generate Specialty Tasks

`POST /api/asclepius/generation/{specialty}`

## 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/generation/{specialty}`
- Auth: none declared

Generate ``count`` validated tasks (prompt + 2 candidates) for a specialty.

nephrology is the only enabled specialty in v1; any other returns 400. With
no LLM configured, returns 503 (we never emit ungated synthetic tasks).

## Path parameters

- `specialty` string, required

## Headers

- `authorization` string, nullable

## Request body

- GenerationRequest: Admin "Generate N nephrology tasks" (Seedmaker, PRD §10).
  - `count` integer
  - `difficulty_mix` object, nullable
  - `capture_reasoning` boolean
  - `grounding_mode` string
  - `independent_mode` string
  - `max_labels` integer
  - `buyer_request_id` string, nullable
  - `multimodal` boolean

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