Upload File

The File Upload API allows you to submit audio files for transcription. Files are processed asynchronously, and you can check the status using the Get File Status endpoint.

Endpoint

POST https://infer.voice.intron.io/file/v1/upload

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Request

Supported File Formats

Format	Extensions
WAV	.wav
MP3	.mp3
MP4	.mp4
M4A	.m4a
OGG	.ogg
WebM	.webm
FLAC	.flac

use category options

file_category_general
file_category_telehealth
file_category_procedure
file_category_call_center
file_category_legal
file_category_meeting_notes

Headers

Header	Value	Required
`Authorization`	`Bearer YOUR_API_KEY`	Yes
`Content-Type`	`multipart/form-data`	Yes

Request Body form-data

Field	Type	Description	Required	Options	Default
`audio_file_name`	String	non-unique file name	yes
`audio_file_blob`	String	url to a readable file	yes
Post processing options
`use_diarization`	String	get the transcript text as a diarized response	no	`TRUE` \| `FALSE`
`use_template_id`	String	use a custom prompt id for the transcript post-processing	no
`use_category`	String	set the category of post-processing to use on the file	no		file_category_telehealth

Post processing options for the file categories

Field	Type	Description	Required	Options	Default
`get_summary`	String	get a summary of the transcript	no	`TRUE` \| `FALSE`

Field	Type	Description	Required	Options
`get_summary`	String	get a summary of the transcript	no	`TRUE` \| `FALSE`
`get_entity_list`	String	get extracted entities from the transcript	no	`TRUE` \| `FALSE`
`get_treatment_plan`	String	get extracted treatment plan from the transcript	no	`TRUE` \| `FALSE`
`get_soap_note`	String	get extracted SOAP note from the transcript	no	`TRUE` \| `FALSE`
`get_clerking`	String	get extracted clerking from the transcript	no	`TRUE` \| `FALSE`
`get_icd_codes`	String	get the extracted icd/billing codes	no	`TRUE` \| `FALSE`
`get_suggestions`	String	get suggestions of important questions to ask or instructions to give patient	no	`TRUE` \| `FALSE`
`get_differential_diagnosis`	String	get the differential diagnosis of the patient	no	`TRUE` \| `FALSE`
`get_followup_instructions`	String	get follow up instructions for the patient	no	`TRUE` \| `FALSE`
`get_practice_guidelines`	String	get practice guidelines for the patient	no	`TRUE` \| `FALSE`

Field	Type	Description	Required	Options
`get_summary`	String	get a summary of the transcript	no	`TRUE` \| `FALSE`
`get_entity_list`	String	get extracted entities from the transcript	no	`TRUE` \| `FALSE`
`get_treatment_plan`	String	get extracted treatment plan from the transcript	no	`TRUE` \| `FALSE`
`get_op_note`	String	get the extracted operation note	no	`TRUE` \| `FALSE`
`get_icd_codes`	String	get the extracted icd/billing codes	no	`TRUE` \| `FALSE`
`get_suggestions`	String	get suggestions of important questions to ask or instructions to give patient	no	`TRUE` \| `FALSE`

Field	Type	Description	Required	Options
`get_summary`	String	get a summary of the transcript	no	`TRUE` \| `FALSE`
`get_call_center_results`	String	get the resolution of a call	no	`TRUE` \| `FALSE`
`get_call_center_agent_score`	String	get the performance score for the agent in a call	no	`TRUE` \| `FALSE`
`get_call_center_agent_score_category`	String	get the performance assessment	no	`TRUE` \| `FALSE`
`get_call_center_product_info`	String	get the product information discussed in the call	no	`TRUE` \| `FALSE`
`get_call_center_product_insights`	String	get ideas to improve the product based on customer feedback in the call	no	`TRUE` \| `FALSE`
`get_call_center_compliance`	String	get the compliance check of the call	no	`TRUE` \| `FALSE`
`get_call_center_feedback`	String	get the feedback of the call	no	`TRUE` \| `FALSE`
`get_call_center_sentiment`	String	get caller sentiment analysis	no	`TRUE` \| `FALSE`

Field	Type	Description	Required	Options	Default
`get_legal_court_hearing`	String	get the transcript in court hearing format	no	`TRUE` \| `FALSE`

Field	Type	Description	Required	Options
`get_summary`	String	get a comprehensive summary of the meeting	no	`TRUE` \| `FALSE`
`get_meeting_notes_participants`	String	get the list of meeting participants and their roles	no	`TRUE` \| `FALSE`
`get_meeting_notes_decisions`	String	get the key decisions made during the meeting	no	`TRUE` \| `FALSE`
`get_meeting_notes_action_items`	String	get list of action items and their assigned owners	no	`TRUE` \| `FALSE`
`get_meeting_notes_key_topics`	String	get the main topics discussed during the meeting	no	`TRUE` \| `FALSE`
`get_meeting_notes_next_steps`	String	get follow-up steps and next meeting plans	no	`TRUE` \| `FALSE`

Basic request and response sample

curl --location 'https://infer.voice.intron.io/file/v1/upload' \
  --header 'Authorization: Bearer api-key' \
  --form 'audio_file_name="my_file_2"' \
  --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"'

Request and response with custom template id

curl --location 'https://infer.voice.intron.io/file/v1/upload' \
  --header 'Authorization: Bearer api-key' \
  --form 'audio_file_name="my_file_2"' \
  --form 'use_template_id="a3f32e46-afa4-42cb-9155-522dcf9xyxyxd"' \
  --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"'

Next Steps

After uploading a file, use the Get File Status endpoint to check the transcription progress and retrieve results.

For real-time transcription, consider using the Widget Integration instead.

Getting Started

Widget

File API

TTS API

Voice Bots API

Endpoint

Authentication

Request

Supported File Formats

use category options

Headers

Request Body form-data

Post processing options for the file categories

Basic request and response sample

Request and response with custom template id

Next Steps

Getting Started

Widget

File API

TTS API

Voice Bots API

​Endpoint

​Authentication

​Request

​Supported File Formats

​use category options

​Headers

​Request Body form-data

​Post processing options for the file categories

​Basic request and response sample

​Request and response with custom template id

​Next Steps

Endpoint

Authentication

Request

Supported File Formats

use category options

Headers

Request Body form-data

Post processing options for the file categories

Basic request and response sample

Request and response with custom template id

Next Steps