Skip to main content
GET
/
jobs
curl "https://trio.machinefi.com/jobs?status=running&limit=10"

{
  "jobs": [
    {
      "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "running",
      "job_type": "live-monitor",
      "created_at": "2024-01-26T10:30:00Z",
      "stream_url": "https://youtube.com/watch?v=abc123",
      "details": {
        "checks_performed": 45,
        "triggers_fired": 3,
        "frames_skipped": 112
      }
    },
    {
      "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "status": "stopped",
      "job_type": "live-digest",
      "created_at": "2024-01-25T14:20:00Z",
      "stream_url": "https://youtube.com/watch?v=xyz789",
      "details": {
        "summaries_generated": 2
      }
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0
}

​
Overview

Retrieve all jobs (running, stopped, completed, failed) for your account.

​
Request

Optional query parameters:
​
status
string
Filter by status: pending, running, stopped, completed, failed.
​
type
string
Filter by job type: live-monitor or live-digest.
​
limit
integer
default:"20"
Maximum number of jobs to return.
​
offset
integer
default:"0"
Offset into the job list for pagination.

​
Response

Returns a paginated list of jobs.
​
jobs
array
Array of job objects.
​
total
integer
Total number of jobs matching the filters.
​
limit
integer
Limit used for pagination.
​
offset
integer
Offset used for pagination.
​
job_id
string
Unique identifier for the job
​
status
string
Current status: pending, running, stopped, completed, failed
​
job_type
string
Type of job: live-monitor or live-digest
​
created_at
string
ISO 8601 timestamp when the job was created
​
stream_url
string
The stream URL being monitored
​
details
object
Job statistics and metadata
curl "https://trio.machinefi.com/jobs?status=running&limit=10"

{
  "jobs": [
    {
      "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "running",
      "job_type": "live-monitor",
      "created_at": "2024-01-26T10:30:00Z",
      "stream_url": "https://youtube.com/watch?v=abc123",
      "details": {
        "checks_performed": 45,
        "triggers_fired": 3,
        "frames_skipped": 112
      }
    },
    {
      "job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "status": "stopped",
      "job_type": "live-digest",
      "created_at": "2024-01-25T14:20:00Z",
      "stream_url": "https://youtube.com/watch?v=xyz789",
      "details": {
        "summaries_generated": 2
      }
    }
  ],
  "total": 2,
  "limit": 20,
  "offset": 0
}

​
Job Statuses

StatusDescription
pendingJob created but not yet started
runningJob is actively monitoring
stoppedJob was manually cancelled
completedJob finished (summarize jobs only)
failedJob encountered an error