Skip to main content
GET
/
jobs
List Jobs
curl --request GET \
  --url https://trio.machinefi.com/api/jobs \
  --header 'Authorization: Bearer <token>'
{
  "jobs": [
    {
      "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "created_at": "<string>",
      "stream_url": "<string>",
      "job_type": "<string>",
      "details": {},
      "message": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}
Lists monitoring and digest jobs for the current user, with optional filtering and pagination. Use this endpoint as your entry point for dashboards, health checks, and cleanup workflows.

​
Common Uses

  • Build a job table with status and age.
  • Discover active jobs before restarting workers.
  • Filter jobs by type or status before follow-up actions.

​
Workflow

  1. Call GET /jobs to list candidate jobs.
  2. Open one with Get Job Details.
  3. Stop long-running jobs with Cancel Job when needed.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
status
string | null
​
type
string | null
​
limit
integer
default:20
​
offset
integer
default:0

Response

Successful Response

Paginated response for job listing.

​
jobs
JobResponse · object[]
required
​
total
integer
required
​
limit
integer
required
​
offset
integer
required