Skip to main content
POST
Upload Transcript
This API is optional. Use it only when you already have the transcript and don’t need EkaScribe to transcribe audio for you. Instead of uploading audio, you post the transcript text plus the template_id you want it structured into, and EkaScribe returns the structured note. The flow is three calls — no audio upload, no End Session:
The call is asynchronous — it returns 202 with a document_id. Poll Get Session (optionally ?document_id=<id>) or Get Document until the document’s status is success.
If you omit 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.
Sending 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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

session_id
string
required

Session ID returned by Create Session

Example:

"ses_abc123def456"

Body

application/json

Send at least one of transcript or target_language. If both are omitted the request is rejected with 400.

transcript
string

The plain-text transcript of the consultation. This replaces EkaScribe's own transcription — no audio upload is needed for the session.

Example:

"Doctor: What brings you in today?\nPatient: I've had a dry cough and mild fever for the last three days.\n"

template_id
string

Template to structure the transcript into (from List Templates). If omitted, the template requested in Create Session (templates) is used.

Example:

"clinical_notes_template"

target_language
string

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.

Example:

"hi"

Response

Transcript accepted, template generation started

status
string
Example:

"in-progress"

message
string
Example:

"Template generation started in background"

txn_id
string

The session ID the transcript was uploaded to.

Example:

"ses_abc123def456"

b_id
string

Business ID resolved from your access token.

Example:

"123456"

template_id
string
Example:

"clinical_notes_template"

document_id
string

ID of the document being generated. Poll Get Session or Get Document until its status is success.

Example:

"doc_9f8e7d6c"

templates
object[]

Documents created for this request.