---
title: "List Jobs"
method: GET
path: "/v1/jobs"
tags: ["Jobs"]
deprecated: true
---

# List Jobs

`GET /v1/jobs`

> **Deprecated.**

List Jobs

## Query parameters

- `q` string, nullable — Search by name or display name
- `agent_name` string, nullable — Filter by agent name
- `page` integer
- `per_page` integer

## Response `200`

Successful Response

- JobListPublicV1 — A page of jobs.
  - `items` JobPublicV1[], required — Jobs on this page.
    - `agent_name` string, nullable — Name of the agent this job runs.
    - `created_at` string, date-time, nullable — When the job was created.
    - `description` string, nullable — Free-text description of the job.
    - `destination` JobDestinationPublicV1 — Where a job writes its results.
      - `format` 'jsonl' | 'csv' | 'parquet' — Output file format.
      - `path` string, required — Destination path the output is written to.
      - `type` 'file' | 's3', required — Destination kind: a local 'file' or an 's3' bucket.
    - `display_name` string, nullable — Human-friendly job name shown in the UI.
    - `id` string, required — Unique job identifier (job_<n>).
    - `inputs` JobInputsPublicV1 — Configuration for the input data a job processes.
      - `data` object[], nullable — Inline list of input records. Used when type is 'inline'.
      - `file_path` string, nullable — Path to the input file; must start with 's3' or 'file_'. Used for 's3'/'file' types.
      - `node_data` object, nullable — Inline input records keyed by source node id, e.g. {'source_a': [{...}]}. Used when type is 'inline' on a dynamic-workflow job, which has one source node per input file. Mutually exclusive with 'data'.
      - `type` 's3' | 'inline' | 'file', required — How inputs are supplied: an 's3' bucket, 'inline' records, or an uploaded 'file'.
    - `last_run_at` string, date-time, nullable — Timestamp of the most recent run.
    - `last_run_status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING', nullable — Status of the most recent run.
    - `name` string, required — Job name.
    - `schedule` JobSchedulePublicV1 — Cron-based schedule controlling when a job runs automatically.
      - `cron` string, required — Cron expression defining when the job runs.
      - `enabled` boolean, required — Whether the schedule is currently active.
    - `updated_at` string, date-time, nullable — When the job was last updated.
  - `page` integer — Current page number.
  - `per_page` integer — Number of items per page.
  - `total` integer, required — Total number of jobs matching the query.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.net/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/d1947ec7af21/schema)