---
title: "Adapts a speech-therapy exercise to a learner profile (ADHD, dyslexia, dysgraphia, dyspraxia, Tourette syndrome, auti…"
method: POST
path: "/api/adaptive-exercise-agent"
tags: ["AI Agents"]
---

# Adapts a speech-therapy exercise to a learner profile (ADHD, dyslexia, dysgraphia, dyspraxia, Tourette syndrome, auti…

`POST /api/adaptive-exercise-agent`

## Request

- Base URL: `https://platform.vocametrix.com`
- URL: `https://platform.vocametrix.com/api/adaptive-exercise-agent`
- Auth: API key in header `X-API-Key`

## Request body

- object
  - `exerciseText` string, required: REQUIRED. The original exercise text.
  - `profile` string, required: REQUIRED. One of "adhd" | "dyslexia" | "dysgraphia" | "dyspraxia" | "tourette" | "autism" (case-insensitive). Other values return 400 with a `validProfiles` field.
  - `includeTips` string: Optional, default false. If true, the agent includes practitioner tips alongside the adapted exercise.
  - `email` string: Optional. Used by the credit-validation flow.

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `adaptedHTML` string: String — HTML version of the exercise adapted for the chosen profile.
  - `metadata` object: Object: { profile, includeTips, threadId, agentName, processingTimeSeconds, timestamp }.
  - `remaining_credits` number: Number.

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