---
title: "Conversational language-tutor agent that adapts vocabulary to the learner's native language, target language, age gro…"
method: POST
path: "/api/vocabulary-tutor-agent"
tags: ["AI Agents"]
---

# Conversational language-tutor agent that adapts vocabulary to the learner's native language, target language, age gro…

`POST /api/vocabulary-tutor-agent`

## Request

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

## Request body

- object
  - `message` string, required: REQUIRED. The learner's message in the target language.
  - `nativeLanguage` string, required: REQUIRED. The learner's native language code.
  - `targetLanguage` string, required: REQUIRED. The language the learner is studying.
  - `ageGroup` string, required: REQUIRED. Categorical age group label.
  - `topic` string, required: REQUIRED. Conversation topic.
  - `threadId` string: Optional. Thread ID for multi-turn continuity.

## Response `200`

Successful response

- object
  - `success` boolean: Boolean.
  - `response` string: String — the agent's free-form text reply.
  - `threadId` string: Thread ID for the conversation (use to continue).
  - `metadata` object: Object: { nativeLanguage, targetLanguage, ageGroup, topic, runId, runStatus }.

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