pro plan beta access:share a post and tag us

seminaraHelp
HelpAPI & AgentsAPI Overview & Authentication

API Overview & Authentication

Programmatic access for generating and managing sessions.

Seminara offers a programmatic API for advanced users and organizations who want to generate and manage sessions automatically.

Base URL

All API requests should be made to: https://seminara.online/api/v1

API Keys

For server-to-server integrations, you can generate a static API key directly from the Developer Dashboard. Provide this key in the headers of your requests: Authorization: Bearer sk_live_your_api_key

Status Codes

All API endpoints return standard HTTP status codes.

  • 200 OK - Success
  • 400 Bad Request - Missing parameters
  • 401 Unauthorized - Invalid API Key
  • 402 Payment Required - Quota exceeded

Frequently Asked Questions (FAQ)

Q: Can I use the API to upload PDFs directly?

A: Yes, via the POST /api/v1/agent/sessions endpoint (detailed in the next section).

Q: Are there rate limits on the Seminara API?

A: Yes, the API is rate-limited to 100 requests per minute per account to prevent abuse. If you exceed this limit, the API will return a 429 Too Many Requests error.

Q: How do I rotate a compromised API key?

A: You can regenerate your API key instantly from the Developer Dashboard. Once rotated, the old key immediately stops working, and any active integrations must be updated.

Q: Can I access the API from a frontend browser application?

A: For security reasons, the Seminara API is designed for server-to-server communication. Exposing your static API key in frontend code is not supported as it poses a major security risk.