NAnace
operations

list_jobs

Changed on

List jobs for the authenticated tenant, newest first. Cost class: fast.

workspace_id narrows to workspace-scoped jobs; omitting it returns document-operation jobs too. kind is the idiomatic way to list all ingestion runs without a dedicated resource.

Pagination is keyset on (created_at, id) — OFFSET would silently miss or duplicate rows when new jobs arrive between pages.

get/v1/jobs

Request

Query parameters

workspace_idstring uuid nullable

Restrict to jobs that run in or read from this workspace. Omit to also include workspace-free document-operation jobs.

kindJobKind[] nullable

Filter by job kind. Filtering by kind makes a separate 'ingestion runs' resource unnecessary.

statusJobStatusInput[] nullable

Filter by job status.

created_afterstring date-time nullable

Restrict to jobs created strictly after this timestamp (UTC).

project_idstring uuid nullable

Restrict to jobs sharing this caller-minted project id (the console's grouped runs).

include_resultboolean

Lists return metadata only. During the console rollout, true is a deprecated compatibility mode limited to one result per page; read complete results with GET /jobs/{job_id}.

cursorstring nullable

Opaque cursor from a previous page's next_cursor. Omit for the first page.

limitinteger

Rows per page.

Response

Successful Response

next_cursorstring nullable

Opaque; null means the last page.

total_countinteger required

Exact, and filtered by the caller's access predicate.

Changes

  • d002a3589a67Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status