---
title: "Send message"
method: POST
path: "/conversations/{uuid}/messages"
tags: ["AI Chatbot"]
---

# Send message

`POST /conversations/{uuid}/messages`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/conversations/{uuid}/messages`
- Auth: none required

Send a user message to an existing conversation and receive the assistant's response

[Docs](https://docs.famulor.io/api-v1/ai-chatbot/send-conversation)

## Path parameters

- `uuid` string, required

## Request body

- object
  - `message` string, required: User message to send (max 2000 characters)

## Response `200`

OK

- object
  - `status` boolean, required: Indicates whether the request succeeded
  - `message` string, required: Assistant's response text
  - `function_calls` object[]: Function calls executed during this message (empty if none)
    - `name` string: Function name
    - `arguments` object: Arguments passed to the function
    - `result` object: Return value from the function

## Other responses

- `400`: Bad Request
- `401`: Fehlender oder ungültiger API-Key.
- `404`: Not Found
- `422`: Validation Error

---

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