Quickstart

Let’s walk through the whole flow with a short file, standup.mp3. You need curl and jq to parse JSON.

Get a token

Send the email and password of your AiGenda account. The response contains a pair of tokens, and you need access for requests.

export AIGENDA_EMAIL="you@example.com"
export AIGENDA_PASSWORD="your-password"

TOKEN=$(curl -s -X POST https://api.aigenda.tech/api/token/ \
  -H "Content-Type: application/json" \
  -d "{\"username\": \"$AIGENDA_EMAIL\", \"password\": \"$AIGENDA_PASSWORD\"}" \
  | jq -r .access)

The field is called username, but it holds your email. Learn more: Authentication.

Find your space_id

Recordings live in spaces. Take your personal space, it has is_main_space: true.

SPACE_ID=$(curl -s "https://api.aigenda.tech/api/spaces/?limit=50&offset=0" \
  -H "Authorization: Bearer $TOKEN" \
  | jq -r '.results[] | select(.is_main_space) | .space.id')

Create a recording

Pass the title, the exact file size in bytes, and the MIME type. The title must end with the file extension.

FILE=standup.mp3
SIZE=$(wc -c < "$FILE" | tr -d ' ')

CREATED=$(curl -s -X POST "https://api.aigenda.tech/api/spaces/$SPACE_ID/audio/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"title\": \"$FILE\", \"size\": $SIZE, \"content_type\": \"audio/mpeg\"}")

AUDIO_ID=$(echo "$CREATED" | jq -r .id)
UPLOAD_URL=$(echo "$CREATED" | jq -r '.url[0]')

url contains an array of upload links, one per file part of about 10 MB. In this quickstart you send the whole file to the first link and complete the upload with a single part. For a production integration, upload in parts, see Uploading a file.

Upload the file and complete the upload

Send the file to the link with PUT and save the ETag header from the response. Then tell AiGenda that the upload is finished.

ETAG=$(curl -s -X PUT "$UPLOAD_URL" --upload-file "$FILE" -D - -o /dev/null \
  | grep -i '^etag:' | cut -d' ' -f2 | tr -d '\r')

curl -s -X POST "https://api.aigenda.tech/api/spaces/$SPACE_ID/audio/$AUDIO_ID/complete_upload/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg etag "$ETAG" '{parts: [{PartNumber: 1, ETag: $etag}]}')"

until curl -s "https://api.aigenda.tech/api/spaces/$SPACE_ID/audio/$AUDIO_ID/info/" \
  -H "Authorization: Bearer $TOKEN" | jq -e .is_uploaded > /dev/null; do sleep 2; done

ETag comes wrapped in double quotes, and you must pass it as is. The loop at the end waits until AiGenda confirms the file (is_uploaded: true).

Start processing

curl -s -X POST https://api.aigenda.tech/api/audio/classify/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"audio_id\": $AUDIO_ID}"

At this point the plan is charged minutes for the recording’s duration.

Fetch the protocol

Poll the result every 15 seconds until you get classified: true. If success is false at that point, processing failed.

while true; do
  RESULT=$(curl -s "https://api.aigenda.tech/api/spaces/$SPACE_ID/audio/$AUDIO_ID/result/" \
    -H "Authorization: Bearer $TOKEN")
  echo "$RESULT" | jq -e '.classified == true' > /dev/null 2>&1 && break
  sleep 15
done

echo "$RESULT" | jq -r .result.protocol > protocol.md

Done: the meeting protocol is in protocol.md.

This loop cannot tell failed processing from processing in progress, so it will wait forever. In a production integration, handle errors following the rules on the Status and polling page.

Get started

Upload a recording

Processing and results

Reference

What’s next

Uploading large files

Result structure

​What’s next

Uploading large files

Result structure

What’s next