Skip to main content
GET
/
jobs
/
{job_id}
curl https://trio.machinefi.com/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "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",
  "config": {
    "condition": "Is it snowing?",
    "interval_seconds": 30,
    "model": "gemini-2.5-flash",
    "webhook_url": "https://example.com/webhook"
  },
  "stats": {
    "checks_performed": 45,
    "triggers_fired": 3,
    "frames_skipped": 112
  }
}

​
Overview

Retrieve detailed information about a specific job, including statistics on frames processed, triggers fired, and frames skipped.

​
Request

​
job_id
string
required
The job ID returned when the job was created

​
Response

​
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
​
config
object
Job configuration (varies by job type). Common fields include:
  • condition
  • interval_seconds
  • window_minutes
  • capture_interval_seconds
  • model
  • webhook_url
​
stats
object
Job statistics including:
  • checks_performed - Number of VLM checks run
  • triggers_fired - Times the condition was met
  • frames_skipped - Frames filtered by pre-filter
  • summaries_generated - Summaries produced (live-digest)
  • auto_stopped - Whether job auto-stopped due to time limit
  • reason - Why the job stopped (if applicable)
  • elapsed_seconds - Total duration if auto-stopped
curl https://trio.machinefi.com/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "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",
  "config": {
    "condition": "Is it snowing?",
    "interval_seconds": 30,
    "model": "gemini-2.5-flash",
    "webhook_url": "https://example.com/webhook"
  },
  "stats": {
    "checks_performed": 45,
    "triggers_fired": 3,
    "frames_skipped": 112
  }
}
See: Job Statistics guide for detailed explanations of each metric and how to interpret them.