Databricks icon

Databricks

Interact with Databricks API

Jobs → Run Job

AI-generated

Summary

Trigger a new run of an existing Databricks job, optionally overriding job-level and task-specific parameters, and return details about the initiated run.

Inputs

  • Job (required) — Select the Databricks job to run either from a searchable list or by entering the job ID directly.
  • Job Parameters — Optional JSON object specifying key-value pairs to override the job's default parameters, accessible in tasks via {{job.parameters.}}.
  • Notebook Params — Optional JSON object of key-value pairs to pass as parameters specifically to notebook tasks within the job.
  • Python Params — Optional JSON array of string parameters to pass to Python file tasks within the job.
  • JAR Params — Optional JSON array of string parameters to pass to JAR tasks within the job.

Output shape

a single record with details about the initiated job run

The output includes the run ID, the run's sequence number within the job, a URL to view the run in the Databricks UI, and the current state of the run. The operation immediately returns after triggering the run and fetches the run details once initiated.

Examples

Example 1: Run a job with default parameters

Specify the job ID from the list and leave parameter fields blank to use default job settings.

Example 2: Run a job overriding certain parameters

Provide JSON overrides for jobParameters, notebookParams, pythonParams, or jarParams to customize the execution of specific task types within the job.

Links

Discussion