Skip to main content
Create a new session with a complete YAML agent configuration. Sessions represent individual conversation instances with agents.

​
Request Body

Send the complete agent configuration in YAML or JSON format. 
curl -X POST https://api-be.atthene.com/api/v1/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Session",
    "agent_type": "llm_agent",
    "system_prompt": "You are a helpful customer support agent.",
    "llm_config": {
      "model": "gpt-4o",
      "temperature": 0.7
    },
    "tools": ["tavily_search"]
  }'

​
Response

{
  "success": true,
  "session_id": "session_abc123",
  "config_hash": "a1b2c3d4e5f6"
}
The returned session_id is used for all runtime operations with this session.