---
title: "Generate patient summaries for scheduled appointments"
method: POST
path: "/api/v1/patient-summary/generate/provider-schedule"
tags: ["/api/v1/patient-summary"]
---

# Generate patient summaries for scheduled appointments

`POST /api/v1/patient-summary/generate/provider-schedule`

## Request

- Base URL: `https://sdp.suki.ai`
- URL: `https://sdp.suki.ai/api/v1/patient-summary/generate/provider-schedule`
- Auth: API key in header `sdp_suki_token`

Trigger bulk asynchronous generation of patient summaries for all scheduled appointments on a provider's ingested schedule. Provide `fhir_practitioner_id` in the request body. This endpoint is optimized for pre-visit workflows where summaries need to be generated in advance before the provider's appointments begin. Returns 202 Accepted when the batch job is scheduled. Each appointment will have its own generation job that can be polled individually via the status endpoints. Use this to prepare summaries overnight or at the start of the day before the provider's appointments begin.

## Headers

- `sdp_provider_id` string

## Request body

- ControllersTriggerPatientSummaryGenerationRequest: Request to trigger bulk asynchronous generation of patient summaries for all scheduled appointments on a provider's schedule.
  - `fhir_practitioner_id` string, required: FHIR Practitioner resource identifier for whom to generate summaries.

## Response `202`

Accepted. Generation scheduled.

## Other responses

- `400`: Bad request. The request body or parameters failed validation.
- `401`: Unauthorized. The Suki access token is missing, expired, or invalid.
- `403`: Forbidden. The authenticated user cannot access this resource.
- `500`: Internal server error.

## Changes

- **2026-11-03** `2181be71d4dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/suki/apis/suki-developer-platform/changes/api/v1/patient-summary/generate/provider-schedule/post.md)

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) - [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/suki/apis/suki-developer-platform/revisions/2181be71d4dd?raw)