NAnace
operations

list_jobs

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.

Args: session: Database session. caller: The authenticated tenant. workspace_id: When set, restrict to one workspace. kind: One or more job kinds to include. status: One or more job statuses to include. created_after: Lower bound on created_at (exclusive). project_id: When set, restrict to jobs sharing this grouping id. include_result: Deprecated single-result compatibility mode for old console builds. cursor: Opaque cursor from a previous page's next_cursor. limit: Requested rows per page, capped at JOB_LIST_PAGE_SIZE for legacy clients.

Returns: One page of jobs with an exact total under the same filters.

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

No recorded changes to this operation across all 1 revision of this API.