Skip to main content
PUT
/
meetings
/
upload
cURL
curl -X PUT "https://api.timeless.day/v1/meetings/upload?title=Team%20sync&language=en" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @recording.mp3
{
  "id": "mtg_abc123",
  "status": "processing"
}
The upload endpoint has a stricter rate limit of 10 requests per minute.

Authorizations

Authorization
string
header
required

API token from your Timeless dashboard.

Headers

content-type
string
required

The MIME type of the uploaded file.

Supported audio types: audio/mpeg, audio/mp4, audio/wav, audio/webm, audio/ogg, audio/aac, audio/flac

Supported video types: video/mp4, video/webm, video/ogg, video/quicktime

Query Parameters

title
string | null

Optional title for the recording (max 500 characters).

Maximum string length: 500
language
string | null

Language code for transcription (e.g., en, es).

Maximum string length: 10

Response

Upload accepted for processing.

id
string
required

The meeting ID for the uploaded recording. Use this to track processing status.

Example:

"mtg_abc123"

status
string
default:processing

Always processing on successful upload.

Allowed value: "processing"