Skip to main content
POST
Launch a job

Body

application/json
id
string

The name of the job configuration. This is distinct from the job run ID (found in job status responses), which identifies a specific job run.

Example:

"api-test-app_click_signals_aggregation"

sparkConfig
object[]

The configuration for this Spark job. The available keys depend on the job type. You can use the /spark/schema endpoint to fetch the configuration schemas for all Spark job types.

type
enum<string>

The Spark job type.

Available options:
aggregation,
als_recommender,
argo-classification,
argo-data-augmentation,
argo-delete-model,
argo-delete-ray-model,
argo-deploy-model,
argo-deploy-ray-model,
argo-item-recommender-content,
argo-item-recommender-user,
argo-milvus-create-collections,
argo-milvus-create-indexes,
argo-milvus-delete-collections,
argo-milvus-delete-indexes,
argo-qna-coldstart,
argo-qna-evaluate,
argo-qna-supervised,
argo-upload-model,
build-training,
cluster_labeling,
custom_python_job,
custom_spark_scala_job,
doc_clustering,
experiment_sql,
ground_truth,
headTailAnalysis,
logistic_regression_classifier_trainer,
outlier_detection,
parallel-bulk-loader,
query_similarity,
random_forests_classifier,
ranking_metrics,
script,
similar_queries,
sip,
sql_template,
synonymDetection,
tokenPhraseSpellCorrection,
transfer,
trending-recommender,
word2vec

Response

200 - application/hal+json

OK

state
enum<string>
Available options:
unknown,
idle,
starting,
running,
finishing,
cancelling,
finished,
cancelled,
error,
skipped
Example:

"finished"

jobId
string

The job run ID. This is distinct from id which is the name of the job configuration.

Example:

"hhzitrwancwv"

jobConfig
object
Example:
hostname
string
Example:

"driver-api-test-app-click-signal-sjnamxwxsyhq"

result
object
Example:
startTime
string
Example:

"2025-10-16T19:49:15.106Z"

endTime
string
Example:

"2025-10-16T19:49:42.276Z"

duration
integer<int64>
Example:

27170