Manage data jobs

Use the data jobs API to list and filter jobs, clone a job, update names and instructions, and cancel in-progress alignment runs.

List data jobs

Endpoint: GET /v1/flow/data-jobs Returns a paginated list of all data jobs for the authenticated user.

from seekrai import SeekrFlow

client = SeekrFlow()

jobs = client.data_jobs.list()
for job in jobs.data:
    print(job.id, job.name, job.status, job.created_at)

Filter and sort

Parameter	Type	Options	Default
`job_type`	string	`principle_files`, `context_grounded_files`, `context_grounded_vector_db`	—
`sort_by`	string	`name`, `created_at`, `job_type`	`created_at`
`sort_order`	string	`asc`, `desc`	`desc`
`limit`	int	1–100	25
`offset`	int	≥ 0	0

# List only principle_files jobs, most recent first
jobs = client.data_jobs.list(
    job_type="principle_files",
    sort_by="created_at",
    sort_order="desc",
    limit=10,
)
for job in jobs.data:
    print(job.id, job.name, job.status)

Get job detail

Endpoint: GET /v1/flow/data-jobs/{id} Returns the full job detail including ingestion jobs, file records, timeline events, and alignment status. See Monitor ingestion for a field-by-field reference.

detail = client.data_jobs.retrieve("dj-1234567890")
print("Status:", detail.status)
print("Files:", len(detail.files))
print("Ingestion jobs:", len(detail.ingestion_jobs))

Clone a data job

Endpoint: POST /v1/flow/data-jobs/{id}/clone Create a new, editable data job pre-populated from an existing one. The clone copies the source job’s configuration and starts as a fresh job that you can adjust before starting alignment. Give the clone a new name, or omit name to reuse the source job’s name.

clone = client.data_jobs.clone(
    "dj-1234567890",
    name="Customer support refresh v3",
)
print("Cloned job ID:", clone.id)

Cloning returns the full job detail, the same shape as Get job detail.

Update job attributes

Endpoint: PATCH /v1/flow/data-jobs/{id} Update the job name, instructions, system prompt, or vector database ID without recreating the job.

data_job = client.data_jobs.update(
    "dj-1234567890",
    name="Customer support refresh v2",
    instructions="Cover airline escalation policies in the generated dataset.",
    system_prompt="You are an airline support expert. Always cite the policy section.",
)
print("Updated name:", data_job.name)

Editable fields:

Field	Notes
`name`	Keep under 255 characters.
`instructions`	Natural-language instructions that guide alignment toward the intended task.
`system_prompt`	Required for `principle_files` jobs before starting. Immediately overwrites the stored value.
`vector_database_id`	Required for `context_grounded_vector_db` jobs before starting.

Once alignment starts, job inputs are locked. Attempting to update a running job returns 409 Conflict.

Cancel a job

Endpoint: POST /v1/flow/data-jobs/{id}/cancel Cancels the alignment run associated with the data job. Only applies when alignment is in pending, queued, or running state.

client.data_jobs.cancel("dj-1234567890")
print("Job cancelled.")

Attempting to cancel a job whose alignment is not in a cancellable state returns 304 Not Modified.

​List data jobs

​Filter and sort

​Get job detail

​Clone a data job

​Update job attributes

​Cancel a job

List data jobs

Filter and sort

Get job detail

Clone a data job

Update job attributes

Cancel a job