Third-party AI agents can programmatically generate fully-hosted Seminara sessions for their users using this endpoint.
POST /api/v1/agent/sessions
Creates a new draft session, generates a unique join link, and applies the user's default settings (CTA recovery, follow-up tone).
Headers
Authorization: Bearer sk_live_...
Content-Type: application/json
Request Body
{
"title": "string (Required)",
"description": "string (Optional)",
"mode": "isolated | broadcast (Optional, defaults to isolated)"
}
Response (200 OK)
{
"sessionId": "uuid",
"slug": "string",
"code": "string",
"shareLink": "https://seminara.online/join/slug"
}
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.
Please note that this endpoint enforces the user's subscription quotas. If the user has exhausted their active session limit, the API will return a 402 Payment Required error.
Frequently Asked Questions (FAQ)
Q: Does this endpoint generate the slides?
A: This endpoint initializes the session wrapper. You must subsequently use the /api/sessions/generate-slides endpoint (or instruct the user to upload their PDF via the UI) to populate the visual content.