notes

Import from a public link, or open a direct upload

Two mutually exclusive shapes:

  • audioUrl: import a YouTube video, a podcast (RSS feed or Apple Podcasts page) or a direct audio/video file URL. Spotify is not supported (DRM).
  • filename + contentType: open a direct upload. The response carries a presigned upload.url; PUT the bytes there and then call POST /v1/notes/{id}/finalize.

Transcription is asynchronous: poll GET /v1/notes/{id} until status is "ready".

post/v1/notes

Request

  • Base URL: https://api.audiomap.ai
  • URL: https://api.audiomap.ai/v1/notes
  • Auth: HTTP bearer

Request body

audioUrlstring uri

Public link to import

filenamestring

Direct upload: original file name

contentTypestring

Direct upload: audio/* or video/*

fileSizeBytesinteger
titlestring
languagestring

Force a locale (es-ES, en-US…). Default: auto-detect

keepAudioboolean

Direct upload: keep the audio beyond the retention window

Response

Note created and queued

noteIdstring uuid required
status'processing' required
providerstring

Import only: youtube | apple-podcasts | podcast-rss | direct

nextstring

What to do next, in plain words

Changes

No recorded changes to this operation across all 1 revision of this API.