Create transcription record

Creates a new transcription record for audio-to-text conversion from patient-doctor conversations. This is the first step in the clinical documentation workflow - stores the raw transcription from a doctor-patient conversation before AI processing.

POST /v1/transcriptions/create

Create transcription record

cURL

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"
}
'

201

{
  "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"
  }
}

Autorizaciones

Authorization · string · header · requerido

Bearer token for API authentication

Encabezados

x-doctor · string · requerido

Doctor identifier for tracking and auditing

x-patient · string

Patient identifier for tracking and auditing

Cuerpo

application/json

duration_seconds · number<float> · requerido

Duration of the recording in seconds

Rango requerido: x >= 0

Ejemplo:

180

original_transcript · string · requerido

The transcribed text from the conversation

Ejemplo:

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

language_used · string

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

Ejemplo:

"en"

Respuesta

201

application/json

Transcription created successfully

message · string · requerido

Ejemplo:

"Transcription created successfully"

transcription · object · requerido

Show child attributes