Upload

File upload operations. Get pre-signed URLs for uploading audio files to cloud storage.

Get pre-signed upload URL

post

Generate a pre-signed URL for uploading audio files directly to Google Cloud Storage.

Workflow

1. Call this endpoint → Get file_id and upload_url

2. Upload file to GCS → Use the upload_url with required headers

3. Wait for confirmation → Upload is automatically confirmed via GCS Eventarc

4. Start processing → Use file_id in /v1/audio/separate, /v1/audio/enhance, etc.

Upload Example

curl -X PUT "$upload_url" \
    -H "x-goog-if-generation-match: 0" \
    --data-binary @your_audio.wav

Important Notes

• Required Header: x-goog-if-generation-match: 0 (prevents duplicate uploads)

• URL Expiry: 30 minutes

• One-time Use: Re-upload returns 412 Precondition Failed

• No Content-Type needed: Server auto-detects format

Supported Formats

WAV, MP3, FLAC, M4A, AAC, OGG, Opus, WebM, AIFF (max 500MB)

Authorizations

BearerAuth

AuthorizationstringRequired

How to Authenticate

1. Get your token from Timbr Dashboard
2. Click the Authorize button above
3. Enter only the token (e.g., TBR_abc123def456)
4. Click Authorize then Close

Important

• ✅ Correct: TBR_8b3364b5a772328a
• ❌ Wrong: Bearer TBR_8b3364b5a772328a

The 'Bearer ' prefix is added automatically by Swagger UI.

Responses

200

Upload URL generated successfully

application/json

401

Unauthorized - Invalid or missing Timbr authentication

500

Internal server error

post

/v1/upload

HTTPcURLJavaScriptPython

POST /v1/upload HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "file_id": "file_a1b2c3d4e5f67890",
  "upload_url": "https://storage.googleapis.com/...",
  "expires_at": "2026-01-04T12:30:00+00:00",
  "bronze_path": "bronze/uploads/user_123/file_a1b2c3d4e5f67890/original",
  "required_headers": {
    "x-goog-if-generation-match": "0"
  }
}