/
New feature

Jobs API 2.2

Jobs API 2.2 is a Databricks developer experience capability, introduced December 2024.

The current version of the REST API for creating, running, and managing Lakeflow Jobs, released in December 2024 with job queueing on by default and token-based paging for jobs whose task lists run past 100 elements.

  • The version number changes the job, not just the wire format - a job created through 2.2 gets queueing switched on by default, while the very same job created through 2.0 or 2.1 has it off.
  • It did not kill its ancestors - the release note that shipped 2.2 says in the same breath that you can still access versions 2.1 and 2.0.
  • Ask it for a job with more than 100 tasks and it hands you 100 plus a next_page_token - lists of tasks, parameters, job_clusters, and environments all page the same way.

Limitations: Array fields such as tasks and job_clusters are capped at 100 elements per response page, and the List jobs request cannot return more than the first 100 tasks or clusters of a job - page through Get a single job or Get a single run for the rest.

Open in REbricked →
Category
Developer experience
Introduced
December 2024
Also known as
Jobs API, Lakeflow Jobs API, /api/2.2/jobs
Verified
2026-09-11

Sources

Related in Developer experience