EkaScribe APIs
File Upload
This endpoint generates presigned URLs for uploading audio files to S3. It provides the necessary credentials and upload parameters to securely upload files directly to AWS S3.
The process involves two main steps:
- Request Presigned URL: Call this endpoint to get folderPath and uploadData
- Upload File: Use the returned
uploadData
andfolderPath
to upload your file to S3 using multipart form data
POST
File Upload
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
txn_id | string | Yes | Session ID for file upload |
action | string | No | Upload action: ekascribe-v2 |
Response
2. Upload Audio Files
Complete Upload Workflow
HTTP Status Codes
Code | Description |
---|---|
200 | Presigned URL generated successfully |
204 | File uploaded successfully |
403 | Upload failed (expired policy) |
Key Notes
- Same Presigned URL: Both audio files and JSON use the same presigned URL from the API
- JSON Filename: Auto-generated as
{txn_id}.json
in the same folder as audio files - Upload Location: All files (audio + JSON) go to the same S3 folder path
- File Paths: Only filenames are stored in JSON, not full paths
- Metadata: Request body data becomes S3 metadata with
x-amz-meta-
prefix
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Session ID for file upload
Example:
"txn_301"
Upload action type
Available options:
ekascribe-v2
Example:
"ekascribe-v2"
Response
200
application/json
Presigned URL generated successfully
The response is of type object
.
File Upload