Skip to main content
POST
Alignment Generate
The alignment endpoints stop working on November 9, 2026. Use the data jobs workflow: POST /v1/flow/data-jobs to create a job, POST /v1/flow/data-jobs/{data_job_id}/add-files to attach files and convert any non-Markdown files automatically, then POST /v1/flow/data-jobs/{data_job_id}/start to run alignment.

Authorizations

Authorization
string
header
required

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

Body

application/json
instructions
string
required

Instructions that describe the task the alignment job generates data for.

files
string[]
required

IDs of the files to use for alignment.

system_prompt
string | null

Optional system prompt included with every conversation in the generated dataset. If omitted, one is generated from instructions and the source documents.

type
enum<string>
default:principle

Type of alignment task.

Available options:
principle,
context_data
vector_database_id
string | null

Optional ID of the vector database to retrieve context from during context_data alignment.

Response

Success

id
string
required

ID of the alignment job.

created_at
string<date-time>
required

Time the alignment job was created, in ISO 8601 format.

status
enum<string>
required
Available options:
pending,
queued,
running,
cancelled,
failed,
completed,
stopped
updated_at
string<date-time> | null

Time the alignment job was last updated, in ISO 8601 format.

completed_at
string<date-time> | null

Time the alignment job completed, in ISO 8601 format.

stopped_at
string<date-time> | null

Time the alignment job stopped, in ISO 8601 format.

current_step
string | null

The processing step the job is currently working on. null until the job starts running.

step_progress

Progress through the current step. null when no step is in progress.

progress
number | null

Overall completion of the job across all steps. null until progress can be calculated.

estimated_completion_at
string<date-time> | null

Projected completion timestamp (UTC). null until enough progress data is available to produce an estimate.

eta_minutes
integer | null

Estimated number of minutes remaining until the job completes. null until an estimate is available.

status_message
string | null

Human-readable description of the job's current state, suitable for display to end users.

output_files
AlignmentOutput · object[]

Files the alignment job produced.

Last modified on November 4, 2026