> ## 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](/ekascribe/authenticate-and-try)).

```
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](/ekascribe/api-reference/sessions/create-session) | `POST /voice/v1/sessions` |
| [Upload Audio](/ekascribe/api-reference/sessions/upload-audio) | `POST /voice/v1/sessions/{session_id}/audio/{file_sequence}` |
| [Stream Audio](/ekascribe/api-reference/sessions/stream-audio) | `wss://…` (from `upload_url`) |
| [End Session](/ekascribe/api-reference/sessions/end-session) | `POST /voice/v1/sessions/{session_id}/end` |
| [Get Session](/ekascribe/api-reference/sessions/get-session) | `GET /voice/v1/sessions/{session_id}` |
| [Update Session](/ekascribe/api-reference/sessions/update-session) | `PATCH /voice/v1/sessions/{session_id}` |
| [Upload Transcript](/ekascribe/api-reference/sessions/upload-transcript) | `POST /voice/api/v1/transaction/{session_id}/convert-to-template` |
| [Process Template](/ekascribe/api-reference/sessions/process-template) | `POST /voice/v1/sessions/{session_id}/process/template/{template_id}` |

Already have the transcript? [Upload Transcript](/ekascribe/api-reference/sessions/upload-transcript) 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](/ekascribe/api-reference/templates/create-template) (define note formats) and [Documents](/ekascribe/api-reference/documents/create-update-document) (read and edit generated notes).


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