POST
/
v1
/
upload
{
  "400": {},
  "413": {},
  "429": {},
  "analysisId": "<string>",
  "fileId": "<string>",
  "status": "<string>",
  "estimatedTime": 123,
  "createdAt": "<string>"
}

​
Upload Audio

Upload audio files to AuthentiVoice for processing. The system will automatically transcribe the audio and perform fraud analysis.

​
Request

​
file
file
required
The audio file to upload. Supported formats: MP3, WAV, M4A, OGG
​
metadata
object
Additional metadata for the audio file
​
processImmediately
boolean
default:true
Whether to start processing immediately after upload

​
Response

​
analysisId
string
Unique identifier for the analysis
​
fileId
string
Unique identifier for the uploaded file
​
status
string
Processing status: queued, processing, completed, failed
​
estimatedTime
integer
Estimated processing time in seconds
​
createdAt
string
ISO 8601 timestamp of upload

​
Examples

curl -X POST https://api.authentivoice.com/v1/upload \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@/path/to/audio.mp3" \
  -F 'metadata={"callerId":"555-0123","tags":["sales","inbound"]}'

​
Response Example

{
  "analysisId": "ana_1234567890abcdef",
  "fileId": "file_0987654321fedcba",
  "status": "processing",
  "estimatedTime": 120,
  "createdAt": "2024-01-15T10:30:00Z"
}

​
Error Responses

​
400
Bad Request
Invalid file format or missing required fields
{
  "error": {
    "code": "INVALID_FILE_FORMAT",
    "message": "File format not supported. Supported formats: MP3, WAV, M4A, OGG"
  }
}
​
413
Payload Too Large
File size exceeds maximum limit (500MB)
{
  "error": {
    "code": "FILE_TOO_LARGE",
    "message": "File size exceeds maximum limit of 500MB"
  }
}
​
429
Too Many Requests
Rate limit exceeded
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many uploads. Please try again later."
  }
}