Skip to main content
POST
/
file
/
confirm-upload-completion
Confirm Upload Completion
curl --request POST \
  --url https://api.royalti.io/file/confirm-upload-completion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileId": "file-uuid-123",
  "fileName": "spotify_royalties_2024-01.csv",
  "uploadStatus": "completed"
}
'
{ "success": true, "message": "Upload confirmed and auto-processing started successfully", "data": { "fileId": "file-uuid-123", "status": "processing", "uploadedAt": "2024-01-15T10:30:00.000Z", "autoProcessed": true, "requiresConfirmation": false, "detectionSessionId": "session-uuid-456", "jobId": "job-789", "queueName": "royalty-excel-processing", "estimatedCompletionTime": "2024-01-15T10:35:00.000Z" } }
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

This endpoint is called by the frontend after a successful direct upload to Google Cloud Storage using a signed URL. Based on auto-detection settings and confidence thresholds, the file will either be automatically processed or require manual confirmation. Auto-Processing Logic:
  • If detection session status is ‘auto_confirmed’, processing starts immediately
  • If detection session status is ‘detected’, manual confirmation is required
  • Returns processing job information if auto-processing is enabled

​
Code Examples

const response = await fetch('https://api.royalti.io/file/confirm-upload-completion', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "fileId": "sample-fileId",
    "fileName": "sample-fileName",
    "uploadStatus": "sample-uploadStatus"
  })
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
​
fileId
string<uuid>
required

The unique identifier of the uploaded file

​
fileName
string

Original name of the uploaded file (for logging)

​
uploadStatus
enum<string>
default:completed

Status of the upload operation

Available options:
completed,
failed

Response

Upload completion confirmed successfully

​
success
boolean
default:true
​
message
string
​
data
object