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
}

Documentation Index

Fetch the complete documentation index at: https://docs.machinefi.com/llms.txt

Use this file to discover all available pages before exploring further.

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