# Illocution Insights API

## Docs

- [Analyze media file](https://docs.illocution.ai/api-reference/analysis/analyze-media-file.md): Upload a full recording and receive the complete JSON payload once processing completes. This is the canonical "batch" API.
- [Analyze media with streaming](https://docs.illocution.ai/api-reference/analysis/analyze-media-with-streaming.md): Identical payload to /analyze, but the response is an SSE stream. The service emits partial transcripts in real time before the full analysis is available.
- [Live Capture Python Cookbook](https://docs.illocution.ai/api-reference/cookbook/live-capture-python.md): Python recipes for streaming audio chunks and consuming real-time analytics
- [Live Capture Python Cookbook (Sync)](https://docs.illocution.ai/api-reference/cookbook/live-capture-python-sync.md): Synchronous Python recipes for WSGI apps, Lambda, and non-async environments
- [Batch Conversation Analysis](https://docs.illocution.ai/api-reference/endpoint/batch-analyze.md): POST /analyze - Upload and wait for complete analysis
- [Live Capture Sessions](https://docs.illocution.ai/api-reference/endpoint/live-capture.md): Incremental audio ingestion for browser microphones and softphones
- [Metrics & Health](https://docs.illocution.ai/api-reference/endpoint/metrics-health.md): Observability endpoints for monitoring
- [Realtime Replay Stream](https://docs.illocution.ai/api-reference/endpoint/realtime-replay.md): POST /analyze/stream - Upload recording and receive SSE updates
- [Conversation Segmentation](https://docs.illocution.ai/api-reference/endpoint/segment-conversation.md): POST /segment/conversation - Re-segment without re-uploading media
- [Error Handling](https://docs.illocution.ai/api-reference/error-handling.md): Error codes and handling guide
- [Health check](https://docs.illocution.ai/api-reference/health/health-check.md): Basic heartbeat endpoint. Returns status information.
- [Illocution Insights API](https://docs.illocution.ai/api-reference/introduction.md): Enterprise-ready reference for the conversation-intelligence platform that powers docs.illocution.ai
- [Control session lifecycle](https://docs.illocution.ai/api-reference/live-streaming/control-session-lifecycle.md): Control a live session: finalize processing, cancel, or extend TTL.
- [Start live session](https://docs.illocution.ai/api-reference/live-streaming/start-live-session.md): Start a live streaming session for incremental media uploads (softphones, browser mics).
- [Subscribe to SSE events](https://docs.illocution.ai/api-reference/live-streaming/subscribe-to-sse-events.md): Subscribe to Server-Sent Events for a live session. Only one SSE consumer may be attached at a time.
- [Upload media chunk](https://docs.illocution.ai/api-reference/live-streaming/upload-media-chunk.md): Upload ordered media chunks for a live session. Chunks must be uploaded sequentially.
- [Get metrics](https://docs.illocution.ai/api-reference/observability/get-metrics.md): Lightweight observability endpoint for dashboards. Returns SSE throughput and average agent latency per utterance.
- [Quickstart Playbook](https://docs.illocution.ai/api-reference/quickstart.md): Test the API in 30 seconds with our demo key
- [Response Schemas](https://docs.illocution.ai/api-reference/response-schemas.md): Detailed schemas for API responses
- [Segment conversation](https://docs.illocution.ai/api-reference/segmentation/segment-conversation.md): Expose segmentation as a standalone capability for previously analyzed calls.
- [Server-Sent Events (SSE)](https://docs.illocution.ai/api-reference/sse-events.md): Real-time event reference for streaming endpoints

## OpenAPI Specs

- [openapi](https://docs.illocution.ai/api-reference/openapi.json)