(Optional) Get upload signed URLs

Endpoint Overview

Endpoint:

GET /companies/{companyCuid}/orchestrators/{orchestratorCuid}/transcriptionRequests/signedUrl

Description:

This endpoint provides a list of signed URLs for uploading audio files to the system. It should be used when you do not already have audio files stored with signed URLs that our system can download from.

Each call to this endpoint:

• Returns an ordered list of signed URLs for uploading audio segments.
• Also returns a process_cuid that identifies the transcription process these files will belong to.
• Requires you to upload audio files in the same order as the URLs returned.
• The signed URLs are valid for up to 1 hour.

Once uploaded, you can start the transcription process using the associated process_cuid.

Path Parameters

Parameter	Description	Type
companyCuid	Unique identifier of the company	String
orchestratorCuid	Unique ID of the orchestrator	String

Query Parameters

Parameter	Description	Type	Required
num_files	Number of signed URLs to generate (i.e., number of audio files to upload)	Integer	Yes
content_type	MIME type of the audio files (e.g., audio/mp3, audio/wav)	String	Yes

Response

200 – Successful Response

Returns a list of signed URLs and the corresponding process_cuid.

{
  "urls": [
    "https://storage.googleapis.com/my-bucket-name/my-object-name/xxxxxxxx",
    "https://storage.googleapis.com/my-bucket-name/my-object-name/yyyyyyyy"
  ],
  "process_cuid": "abcd1234"
}

Status	Description
401	Unauthorized
403	Forbidden
404	Not Found
422	Validation Error

Upload Your Audio File Using the Signed URL

Once you receive the signed URLs, you can upload your audio files directly to the provided URLs using curl. Make sure to upload each file in the same order as the URLs were returned.

curl -X PUT -T path/to/your-audio-file-1.wav \
  -H "Content-Type: audio/wav" \
  "https://storage.googleapis.com/my-bucket-name/my-object-name/xxxxxxxx"