> ## Documentation Index
> Fetch the complete documentation index at: https://developer.eka.care/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions Overview

> Session-based voice capture and transcription — the core EkaScribe flow

A **session** ties audio capture, processing and results together under one `session_id`. Base path: `/voice/v1` on `https://api.eka.care`. All endpoints except Discovery need `Authorization: Bearer YOUR_ACCESS_TOKEN` ([get a token](https://developer.eka.care/docs/scribe/authenticate-and-try.md)).

```
1. Create Session   POST /voice/v1/sessions                        → session_id, upload_url
2. Send audio       POST /voice/v1/sessions/{id}/audio/{file}     (single/chunked, HTTP)
                    or wss://… WebSocket                           (stream)
3. End Session      POST /voice/v1/sessions/{id}/end               → 202, processing starts
4. Get Session      GET  /voice/v1/sessions/{id}                  (poll ~1s until ≠202)
                    → transcript + structured notes per template
```

| API | Endpoint |
| - | - |
| [Create Session](https://developer.eka.care/api-sdk/scribe/sessions/create-session.md) | `POST /voice/v1/sessions` |
| [Upload Audio](https://developer.eka.care/api-sdk/scribe/sessions/upload-audio.md) | `POST /voice/v1/sessions/{session_id}/audio/{file_sequence}` |
| [Stream Audio](https://developer.eka.care/docs/scribe/sessions/stream-audio.md) | `wss://…` (from `upload_url`) |
| [End Session](https://developer.eka.care/api-sdk/scribe/sessions/end-session.md) | `POST /voice/v1/sessions/{session_id}/end` |
| [Get Session](https://developer.eka.care/api-sdk/scribe/sessions/get-session.md) | `GET /voice/v1/sessions/{session_id}` |
| [Update Session](https://developer.eka.care/api-sdk/scribe/sessions/update-session.md) | `PATCH /voice/v1/sessions/{session_id}` |
| [Upload Transcript](https://developer.eka.care/api-sdk/scribe/sessions/upload-transcript.md) | `POST /voice/api/v1/transaction/{session_id}/convert-to-template` |
| [Process Template](https://developer.eka.care/api-sdk/scribe/sessions/process-template.md) | `POST /voice/v1/sessions/{session_id}/process/template/{template_id}` |

Already have the transcript? [Upload Transcript](https://developer.eka.care/api-sdk/scribe/sessions/upload-transcript.md) is an optional alternative to steps 2–3 — post the transcript and a `template_id` straight to the session, then poll Get Session for the structured note.

Also see [Templates](https://developer.eka.care/api-sdk/scribe/templates/create-template.md) (define note formats) and [Documents](https://developer.eka.care/api-sdk/scribe/documents/create-update-document.md) (read and edit generated notes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.