---
title: "Approve, modify, or reject a generated therapy plan. The action determines the next step: \"approve\" locks the plan as…"
method: POST
path: "/api/therapy-approve/{sessionId}"
tags: ["Therapy Planning"]
---

# Approve, modify, or reject a generated therapy plan. The action determines the next step: "approve" locks the plan as…

`POST /api/therapy-approve/{sessionId}`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/therapy-approve/{sessionId}`
- Auth: API key in header `X-API-Key`

## Path parameters

- `sessionId` string, required

## Request body

- object
  - `action` string, required: REQUIRED in body. "approve" | "modify" | "reject" (case-insensitive).
  - `feedback` string: REQUIRED when action="modify". Free-form clinician notes describing what to change. Optional otherwise.

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `therapy_session_id` string: Echo of the session ID.
  - `action` string: Echo of the action.
  - `feedback` string: Echo of the feedback (or null).
  - `delivery_status` string: On approve: "approved_pending_delivery". On reject: "rejected".
  - `status` string: On modify: "processing" — the workflow re-runs and the client must poll again.
  - `status_message` string: Human-readable description.
  - `status_url` string: (modify only) URL to poll the new run.
  - `result_url` string: (modify only) URL to fetch the new result.
  - `timestamp` string, date-time: ISO 8601.
  - `message` string: Human-readable confirmation.

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)