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.
Q: Can I create a broadcast session programmatically?
A: Absolutely. Simply set the mode parameter to broadcast in your request body to allow hundreds of attendees to join the same live session.
Q: What happens if the title I provide is extremely long?
A: The title is truncated to 150 characters on our end for UI consistency. It's best to keep session titles concise and engaging.
Q: Can I update the session details after it's been created via the API?
A: Currently, the API supports session creation. To edit the title or description, you'll need to open the session in the Host Dashboard. Update endpoints are on our roadmap.