pro plan beta access:share a post and tag us to claim

Seminara Help
HelpAPI & AgentsAgent Capabilities & API

Agent Capabilities & API

How external AI agents can authenticate and manage Seminara sessions autonomously.

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 instantly spin up a new AI-hosted presentation, webinar, 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. Future Capabilities

We are actively expanding the agentic API. Upcoming endpoints will allow agents to:

  • Upload slides and PDFs directly from your local filesystem.
  • Configure Aura's voice and personality traits.
  • Manage Call-to-Actions (CTAs) and session outlines.
  • Retrieve engagement analytics and transcript summaries after a session concludes.

🛠️ Building Your Own Agent Integration

If you are building your own AI tool or LLM application and want it to leverage Seminara's Agentic capabilities natively, simply ingest our openapi.json specification into your framework (like LangChain or LlamaIndex) and configure Bearer authentication.

The Seminara platform will handle the rest, transforming your LLM's text output into live, interactive, voice-driven presentation experiences.