Skip to main content
Sends a user message to an existing conversation and returns the assistant’s response. The assistant processes the message using its configured AI model and any available tools.

​
Endpoint

POST /conversations/{uuid}/messages

​
Path parameters

​
uuid
string
required
UUID of the conversation to send the message to.

​
Request

​
message
string
required
The user’s message. Maximum 2000 characters.

​
Response

​
status
boolean
Whether the request was successful.
​
message
string
The assistant’s response.
​
function_calls
array
Functions executed by the assistant while processing the message. Empty array if none were called.

​
Example

curl -X POST "https://portal.intellixent.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{"message": "I would like to schedule a demo for next week"}'
200 Success
{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}
200 With function calls
{
  "status": true,
  "message": "I've checked our calendar and found available slots for next week.",
  "function_calls": [
    {
      "name": "check_calendar_availability",
      "arguments": {
        "start_date": "2025-01-13",
        "end_date": "2025-01-17"
      },
      "result": {
        "available_slots": ["2025-01-13 14:00", "2025-01-15 10:00"]
      }
    }
  ]
}
404 Conversation not found
{
  "status": false,
  "error": "Conversation not found"
}
400 Insufficient balance
{
  "status": false,
  "error": "Insufficient balance. Please top up your account."
}
Each user message in a widget conversation costs $0.01. Test conversations are free.