Skip to main content

​
Overview

The Jobs tab displays a paginated list of all your download jobs, with filtering options for quick access to specific statuses.

​
Jobs Table

ColumnDescription
Job IDUnique identifier (first 8 characters shown)
Source URLThe original URL submitted (truncated)
StatusCurrent job status with color-coded badge
Output KeyS3 key where the file was uploaded

​
Status Badges

Pending

● Pending
Job is queued

Processing

● Processing
Currently active

Completed

● Completed
Successfully finished

Failed

● Failed
Error occurred

​
Pagination

Jobs are displayed 50 per page. Use the navigation buttons to browse:
  • Previous: Go to earlier jobs
  • Next: Go to more recent jobs
The page info shows your current position: 1-50 of 1523

​
Filtering

​
By Status

The Failed tab shows only failed jobs with their error messages. This helps you quickly identify and debug issues.

​
Via API

Filter jobs programmatically: 
# Get all jobs
curl "https://tornado.velys.software/dashboard/jobs?limit=50&offset=0" \
  -H "x-api-key: sk_your_api_key"

# Get only failed jobs
curl "https://tornado.velys.software/dashboard/jobs?status=failed&limit=100" \
  -H "x-api-key: sk_your_api_key"

​
Response Format

{
  "jobs": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
      "status": "Completed",
      "error": null,
      "s3_key": "videos/never-gonna-give-you-up.mp4"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "url": "https://youtube.com/watch?v=...",
      "status": "Failed",
      "error": "Video unavailable",
      "s3_key": null
    }
  ],
  "total": 1523,
  "limit": 50,
  "offset": 0
}

​
Error Messages

Failed jobs include sanitized error messages. Common errors:
ErrorMeaning
Video unavailableThe video was deleted or is private
Sign in to confirmAge-restricted content requiring authentication
Rate limitedPlatform rate limiting (usually temporary)
Format not availableRequested format doesn’t exist for this video
Connection timeoutNetwork issue during download
Error messages are sanitized to remove internal tool names. “yt-dlp” is replaced with “downloader” for clarity.

​
Use Cases

​
Debugging Failures

  1. Go to the Failed tab
  2. Review error messages
  3. Check if URLs are still accessible
  4. Retry failed jobs if the issue was temporary

​
Tracking Progress

  1. Go to the All Jobs tab
  2. Look for jobs with “Processing” status
  3. Refresh to see updates (auto-refreshes every 10 seconds)

​
Finding Completed Files

  1. Locate the job in the list
  2. Copy the Output Key (S3 path)
  3. Access the file in your S3 bucket or use the presigned URL from the job status API