Skip to main content
POST
/
v1
/
notes
/
from-audio
curl --request POST \
  --url https://api.caret.so/v1/notes/from-audio \
  --header 'Authorization: Bearer <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "audioUrl": "https://caret-cdn.s3.us-west-1.amazonaws.com/audio/temp_upload_..."
  }'

{
  "noteId": "mtg_987654321"
}
This endpoint is available only for Enterprise plan users.

​
Request Body

​
audioUrl
string
required
The URL of the uploaded audio file (obtained from Generate Audio Upload URL)
​
title
string
Optional title for the note
​
calendarEventId
string
Optional calendar event ID to associate with the note
​
folderId
string
Optional folder ID to place the note in

​
Response

​
noteId
string
The ID of the created note
curl --request POST \
  --url https://api.caret.so/v1/notes/from-audio \
  --header 'Authorization: Bearer <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "audioUrl": "https://caret-cdn.s3.us-west-1.amazonaws.com/audio/temp_upload_..."
  }'

{
  "noteId": "mtg_987654321"
}

​
Usage Flow

  1. First, call Generate Audio Upload URL to get a presigned URL
  2. Upload your audio file to the presigned URL using a PUT request
  3. Call this endpoint with the audioUrl returned from step 1
The note will be created with status postprocessing and will be processed asynchronously. Once processing is complete, the note will contain the transcript and AI-generated summary.