Create Chat Session

Creates a new chat session. Sessions store conversation history and can be associated with a specific agent.

POST /api/v1/chat/session — 🔒 Requires Auth

Request Body

Field	Type	Required	Description
agent_id	string		Associate session with an agent
agent_url	string		Direct agent endpoint URL

Examples

curl

curl -X POST https://nasiko.dev/api/v1/chat/session \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent-abc123",
    "agent_url": "https://weather-agent.example.com"
  }'

Python

import httpx

response = httpx.post(
    "https://nasiko.dev/api/v1/chat/session",
    headers={"Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},
    json={
        "agent_id": "agent-abc123",
        "agent_url": "https://weather-agent.example.com",
    },
)
session_id = response.json()["data"]["session_id"]
print(f"Session: {session_id}")

JavaScript

const res = await fetch("https://nasiko.dev/api/v1/chat/session", {
  method: "POST",
  headers: {
    Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    agent_id: "agent-abc123",
    agent_url: "https://weather-agent.example.com",
  }),
});
const { data } = await res.json();
const sessionId = data.session_id;