Skip to main content
Execute a message in an existing session and get the agent’s response.
​
session_id
string
required
The session ID

​
Request Body

​
content
string | array
required
The message content. Can be a simple string or multimodal content blocks.
​
correlation_id
string
Optional correlation ID for tracking related events

​
Simple Text Message

curl -X POST https://api-be.atthene.com/api/v1/runtime/session_abc123/execute/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "What is the weather like today?"
  }'

​
Multimodal Message (with images)

{
  "content": [
    {
      "type": "text",
      "text": "What's in this image?"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/image.jpg"
      }
    }
  ]
}

​
Response

{
  "success": true,
  "message_id": "msg_789",
  "response": {
    "content": "Based on the current weather data, it's sunny and 72°F today.",
    "tool_calls": []
  },
  "correlation_id": "corr_123"
}
The response includes the agent’s generated content and any tool calls that were made during execution.