Agent Capabilities & API

Seminara is an Agentic Presentation Platform. Beyond just human users interacting with our dashboard, Seminara is designed from the ground up to be fully accessible to third-party AI agents (such as Claude Code, GitHub Copilot, Codex, or custom AI assistants).

This means your AI agents can programmatically authenticate, create, and manage presentation sessions on your behalf, without you ever needing to leave your terminal or chat interface.

🤖 The Agent Discovery Protocol

Seminara explicitly tells other AI agents how to interact with it via our llms.txt and openapi.json files. If you point an intelligent agent at our root domain, it will automatically discover:

• Our Agent Catalog (/.well-known/ai-catalog.json)
• Our OpenAPI Specification (/openapi.json)
• The Agent Instructions (/llms.txt)

These files act as the "system prompt" for external AIs, detailing the exact API endpoints and authentication flows they must use to operate Seminara.

🔐 Agentic Authentication (OAuth Device Flow)

Because AI agents often run in environments without traditional web browsers (like a CLI or a headless server), Seminara supports the OAuth Device Authorization Flow (RFC 8628).

This allows an agent to request access to your account securely:

1. Initiation: The agent calls POST /api/v1/oauth/device/code.
2. User Prompt: Seminara returns a user_code and a verification_uri. The agent displays this to you in your terminal/chat.
3. Approval: You click the link, log into Seminara, and approve the agent's access.
4. Token Issuance: While you are approving, the agent polls POST /api/v1/oauth/device/token. Once approved, Seminara issues a short-lived access_token and a refresh_token to the agent.

The agent can now use this Bearer token to perform actions on your behalf!

⚡ What Can Agents Do?

Currently, authenticated agents can perform the following actions programmatically via our API:

1. Create Sessions

Agents can trigger the creation of a live presentation session, briefing, or product demo.

Endpoint: POST /api/v1/agent/sessions

When you tell your agent: "Create a Seminara session for a product demo," the agent will call this endpoint and return the live, shareable URL to you instantly.

2. Session Analytics & Management

Upcoming and current endpoints allow agents to:

• Retrieve engagement analytics and question transcripts after a session concludes.
• Manage Call-to-Actions (CTAs) and session outlines.
• Check real-time session status and attendance data.

🛠️ Triggering Sessions From Your Own Agents

If you are building an AI workflow or agent and want it to trigger Seminara sessions or query session analytics, ingest our openapi.json specification into your agent framework (such as LangChain, LlamaIndex, or custom tool callers) and configure Bearer authentication with your API key.

Programmatic session creation and analytics access require an active paid account with API entitlements (Core Host or Hosting Fleet plan). Once authenticated, your agent can provision presentation rooms on demand, and Aura delivers the live session directly to attendees.

Frequently Asked Questions (FAQ)

Q: Which LLMs are supported via the Agent Discovery Protocol?

A: Seminara is model-agnostic. Because we use standard llms.txt and OpenAPI protocols, any intelligent agent like Claude Code, ChatGPT, or custom LangChain/LlamaIndex agents can authenticate and manage sessions.

Q: Can my agent answer attendee questions directly?

A: The Seminara API is for session management. The real-time, voice-based Q&A during a live session is always handled by Aura using your configured Knowledge Base to guarantee low latency.

Q: How do I revoke an agent's access to my account?

A: You can instantly revoke any authorized agent's token from the Security settings in your Host Dashboard. This immediately terminates their programmatic access.