Sessions API Reference | PraisonAIUI Docs

Health Endpoints Guide
PraisonAIUI
Testing
Api
CLI API Reference
Component API Reference
Features REST API Reference
Health API Reference
Python SDK API
Sessions API Reference
API Testing Guide
TypeScript SDK Reference
Concepts
Architecture: AG-UI Protocol vs Gateway Integration
YAML Configuration
Providers
Slots & Components
Templates & Layouts
Examples
Advanced Examples
Basic Examples
Features
A2UI canvas — agent-driven UI
Agent UI host — modular dashboard shell
Chat Attachments
Backend Integration Contract
Browser Automation
Channel-to-Chat Bridge
Code Execution
Feature Comparison: PraisonAIUI vs OpenClaw
Config Hot-Reload
Content Sources
How the UI Looks Are Built
Dark Mode
Dashboard
Deployment Guide
Device Pairing
What Makes PraisonAIUI Different
Feature Inventory
Gap Analysis — Validated Against praisonai SDK
Gateway Chat
Hot Reload
How to Add a Feature to PraisonAIUI
Internationalization (i18n)
Image Preview in Chat
AIUI Integration — Critical Review & Architecture Analysis
Knowledge Embedding Model Configuration
Plugin Marketplace
Media Analysis
Message Elements
Model Fallback
Navigation
PraisonAI package integration
Protocol Architecture Reference
Protocol Versioning
Feature Protocols
Progressive Web App (PWA)
SEO
Session Management
Standalone vs Integrated
AIUI Standardization — Verification Report
Steps / Chain-of-Thought
UI Styles
Subagent Tree View
Theme System
Theming
Text-to-Speech (TTS)
Video Studio
Widget Zones
Getting Started
CLI Reference
Deploy to GitHub Pages
Installation
Quick Start
Protocols
Application Design Protocol (ADP) — Research Report
Application Design Protocol (ADP)
PraisonAIUI → ADP Field Mapping
ADP Implementation Status
Application Design Protocol (ADP) — Normative Specification
ADP Validation Rules
Typescript
Components
TypeScript SDK Overview
Next.js Adapter
Runtime

Sessions API ReferenceEndpoints`GET /sessions`List all sessions.Response:`GET /sessions/{session_id}`Get full session data including messages.Response:---`GET /sessions/{session_id}/runs`Get message history for a session.Response:---`DELETE /sessions/{session_id}`Delete a session.Response:---`POST /run`Send a message and receive streaming response via SSE.Request:If session_id is omitted or null, a new session is created automatically.Response: Server-Sent Events stream:---`POST /cancel`Cancel an active run.Request:---`GET /health`Server health check.Response:---`GET /agents`List registered agents.Response:Error ResponsesAll endpoints return 404 when a session is not found: