Import audio or video
Import an audio or video file from a URL for transcription, summary and action items.
POST https://cotlet.dev/api/v1/otter/audios
write Confirm
Fetches the file from the URL and imports it into your Otter account as a new conversation. The file must be up to 5 GB, in a supported audio or video format, and reachable without a login. The import counts toward your plan's transcription limits and the transcript is ready when get_conversation shows the processing as finished. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| file_url string required | string | HTTPS URL of the audio or video file, reachable without a login. |
| name string | string | Name for the conversation. Default: the file name. |
Request
curl -X POST https://cotlet.dev/api/v1/otter/audios \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"file_url":"https://example.com/recordings/discovery-call.mp3","name":"Discovery call 14 Oct"}'result = client.call("otter", "import_audio", {"file_url":"https://example.com/recordings/discovery-call.mp3","name":"Discovery call 14 Oct"})const result = await cotlet.call('otter', 'import_audio', {"file_url":"https://example.com/recordings/discovery-call.mp3","name":"Discovery call 14 Oct"});cotlet call otter import_audio --data '{"file_url":"https://example.com/recordings/discovery-call.mp3","name":"Discovery call 14 Oct"}'Example response
{
"conversation_id": "cv_a7710e",
"name": "Discovery call 14 Oct",
"status": "processing"
}