Skip to main content
PATCH
/
v1
/
flow
/
data-jobs
/
{data_job_id}
Update data job
curl --request PATCH \
  --url https://flow.seekr.com/v1/flow/data-jobs/{data_job_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "system_prompt": "<string>",
  "instructions": "<string>",
  "vector_database_id": "<string>"
}
'
{
  "id": "<string>",
  "user_id": "<string>",
  "name": "<string>",
  "job_type": "<string>",
  "alignment_job_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "system_prompt": "<string>",
  "system_prompt_updated_at": "2023-11-07T05:31:56Z",
  "instructions": "<string>",
  "instructions_updated_at": "2023-11-07T05:31:56Z",
  "resolved_instructions": "<string>",
  "vector_database_id": "<string>",
  "additional_alignment_file_ids": [
    "<string>"
  ],
  "ingestion_jobs": [
    {
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "file_ids": [
        "<string>"
      ],
      "records": [
        {
          "record_id": "<string>",
          "ingestion_job_id": "<string>",
          "alignment_file_id": "<string>",
          "user_id": "<string>",
          "filename": "<string>",
          "status": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "metaflow_job_id": "<string>",
          "method": "<string>",
          "queue_position": 123,
          "error_message": "<string>",
          "suggested_fix": "<string>",
          "worker_id": "<string>",
          "deleted": false,
          "processing_at": "2023-11-07T05:31:56Z",
          "completed_at": "2023-11-07T05:31:56Z",
          "failed_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ],
  "alignment_job": {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "current_step": "<string>",
    "step_progress": 123,
    "progress": 123,
    "estimated_completion_at": "2023-11-07T05:31:56Z",
    "eta_minutes": 123,
    "status_message": "<string>"
  },
  "files": [
    {
      "file_id": "<string>",
      "record_id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "suggested_fix": "<string>",
      "bytes": 123
    }
  ],
  "fine_tuning_job_ids": [
    "<string>"
  ],
  "timeline": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "event_type": "<string>",
      "message": "<string>",
      "metadata": {}
    }
  ]
}
Update metadata on an existing data job. Fields are locked once alignment is running. For editable fields and locking behavior, see Manage data jobs.

Authorizations

Authorization
string
header
required

Seekr API Key without 'Bearer' Prefix

Path Parameters

data_job_id
string
required

Body

application/json
name
string | null
Required string length: 1 - 255
system_prompt
string | null
Minimum string length: 1
instructions
string | null
Minimum string length: 1
vector_database_id
string | null

Response

Successful Response

Extends DataJobResponse Full detail payload for the per-job view.

id
string
required
user_id
string
required
name
string
required
job_type
string
required
alignment_job_id
string | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
status
enum<string>
required

Status values for data jobs.

Available options:
file_processing,
needs_review,
ready_to_start,
pending,
queued,
running,
cancelled,
failed,
completed
system_prompt
string | null
system_prompt_updated_at
string<date-time> | null
instructions
string | null
instructions_updated_at
string<date-time> | null
resolved_instructions
string | null
vector_database_id
string | null
additional_alignment_file_ids
string[]
ingestion_jobs
IngestionJobDetail · object[]
alignment_job
AlignmentResponse · object
files
DataJobFile · object[]
fine_tuning_job_ids
string[]
timeline
TimelineEvent · object[]
Last modified on June 18, 2026