Third-party AI agents and automated workflows can programmatically generate fully-hosted, live-ready Seminara sessions using this endpoint.
POST /api/v1/agent/sessions
Creates a new session, generates a unique join link, configures optional CTAs, seeds slide decks, attaches knowledge base context, and optionally activates the session immediately.
Headers
Authorization: Bearer sk_live_...
Content-Type: application/json
Request Body
{
"title": "Product Walkthrough & Live Q&A",
"description": "Interactive demo session hosted autonomously by Aura",
"mode": "isolated", // "isolated" (1-on-1) or "broadcast" (1-to-many)
"ctaText": "Book a Strategy Call",
"ctaUrl": "https://cal.com/example/demo",
"status": "live", // "draft" | "ready" | "live"
"slides": [
{
"slide_number": 1,
"title": "Platform Overview",
"content": "Introduction to autonomous agentic hosting infrastructure.",
"notes": "Emphasize zero camera time and sub-second voice latency."
}
],
"knowledgeBase": [
{
"title": "Security & Architecture FAQ",
"content": "Enterprise data retention policies and WebRTC encryption specs."
}
]
}
Response (200 OK)
{
"sessionId": "b47c9417-640a-4299-8d76-e1791a84f329",
"slug": "product-walkthrough-live-qa-x9a2",
"code": "X9A2F",
"shareLink": "https://seminara.online/live/product-walkthrough-live-qa-x9a2",
"status": "live",
"cta": {
"text": "Book a Strategy Call",
"url": "https://cal.com/example/demo"
},
"slidesCount": 1,
"kbDocumentsCount": 1
}
Agent & API Context
When a session is created via this API, the source column in the database is automatically tagged as agent_api. This allows hosts to track which leads were generated manually vs. generated by your external AI agent.
Quota Enforcement (HTTP 402)
This endpoint enforces the host's subscription quota. If the user has exhausted their active live session limit or monthly presentation minute pool, the API returns HTTP 402 Payment Required. AI agents can programmatically upgrade the subscription via POST /api/v1/agent/checkout.
Frequently Asked Questions (FAQ)
Q: Can I provide slides and knowledge base documents directly during creation?
A: Yes! You can provide a slides array and a knowledgeBase array in the JSON request body. Aura will ingest the context and calibrate presentation flow immediately.
Q: Can I make the session live immediately?
A: Yes. Set "status": "live" (or "isLive": true) in the request payload, and the shareable shareLink will be immediately open for attendees to join and interact.
Q: What happens if the title I provide is extremely long?
A: The title is truncated to 150 characters for UI consistency. It is best to keep session titles concise and engaging.