Skip to main content
POST
/
v1
/
transcriptions
/
create
Create transcription record
curl --request POST \
  --url https://{your-prod-endpoint}/v1/transcriptions/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-doctor: <x-doctor>' \
  --data '
{
  "duration_seconds": 180,
  "original_transcript": "The patient is a 45-year-old male presenting with chest pain radiating to left arm for the past 2 hours...",
  "language_used": "en"
}
'
{
  "message": "Transcription created successfully",
  "transcription": {
    "id": "trans_abc123xyz",
    "user_id": "usr_123456789",
    "group_id": "grp_987654321",
    "duration_seconds": 180,
    "language_used": "en",
    "original_transcript": "The patient is a 45-year-old male...",
    "created_at": "2023-10-09T10:00:00.000Z",
    "updated_at": "2023-10-09T10:00:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token for API authentication

Headers

​
x-doctor
string
required

Doctor identifier for tracking and auditing

​
x-patient
string

Patient identifier for tracking and auditing

Body

application/json
​
duration_seconds
number<float>
required

Duration of the recording in seconds

Required range: x >= 0
Example:

180

​
original_transcript
string
required

The transcribed text from the conversation

Example:

"The patient is a 45-year-old male presenting with chest pain..."

​
language_used
string

Language code (e.g., 'en', 'es', 'fr')

Example:

"en"

Response

Transcription created successfully

​
message
string
required
Example:

"Transcription created successfully"

​
transcription
object
required