Upload Transcript
Optional. Use this only if you already have the transcript and do not want EkaScribe to transcribe audio for you. Instead of uploading audio files, create a session, POST your transcript here along with the template_id you want it structured into, then poll Get Session for the structured result.
The call is asynchronous: it returns 202 with a document_id and status: in-progress. Fetch the structured note with GET /voice/v1/sessions/{session_id} (optionally ?document_id=<document_id>) or Get Document once its status is success.
You may also omit template_id and send target_language instead to translate the transcript (or the session’s stored transcript) into another language.
template_id you want it structured into, and EkaScribe returns the structured note.
The flow is three calls — no audio upload, no End Session:
202 with a document_id. Poll Get Session (optionally ?document_id=<id>) or Get Document until the document’s status is success.template_id, the template requested in Create Session (templates) is used. To structure the same transcript into more templates later, call Process Template — each one creates its own document.target_language instead of template_id translates the transcript into that language (eng, hi, ta, te, bn, mr, gu, kn, ml, pa, as) rather than structuring it into a template.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Session ID returned by Create Session
"ses_abc123def456"
Body
Send at least one of transcript or target_language. If both are omitted the request is rejected with 400.
The plain-text transcript of the consultation. This replaces EkaScribe's own transcription — no audio upload is needed for the session.
"Doctor: What brings you in today?\nPatient: I've had a dry cough and mild fever for the last three days.\n"
Template to structure the transcript into (from List Templates). If omitted, the template requested in Create Session (templates) is used.
"clinical_notes_template"
Translate the transcript into this language instead of structuring it into a template. One of eng, hi, ta, te, bn, mr, gu, kn, ml, pa, as.
"hi"
Response
Transcript accepted, template generation started
"in-progress"
"Template generation started in background"
The session ID the transcript was uploaded to.
"ses_abc123def456"
Business ID resolved from your access token.
"123456"
"clinical_notes_template"
ID of the document being generated. Poll Get Session or Get Document until its status is success.
"doc_9f8e7d6c"
Documents created for this request.

