Skip to main content
POST
Start Data Job Alignment
Start the alignment process for a data job. The job must be in ready_to_start status. Pre-flight checks vary by job type:
  • For principle_files jobs: a system_prompt must be set and files have been added to the data job
  • For context_grounded_files jobs: files must have been added to the data job
  • For context_grounded_vector_db jobs: a vector_database_id must be set
For the full pre-flight requirements and workflow, see Create instruction fine-tuning data.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Path Parameters

data_job_id
string
required

Response

Success

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
required

Status values that exist BEFORE an alignment job is linked. Once linked, the real status comes from AlignmentJobStatus directly — see DataJobResponse.status's union type and derive_data_job_status.

Available options:
file_processing,
needs_review,
ready_to_start
origin_data_job_id
string | null
deleted
boolean
default:false
status_message
string | null
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 | null
files
DataJobFile · object[]
fine_tuning_job_ids
string[]
timeline
TimelineEvent · object[]
Last modified on July 31, 2026