Job definitions, versioning, drafts, and team assignment.
/me/jobsList my jobs
Returns all jobs that the current user can access based on their team memberships.
Includes team associations and latest job run references in the normalized response.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100pageinteger
The page number to retrieve (1-indexed). Used with limit to support offset-based pagination.
"int32"11sortBystring
The field to sort by.
"jobKey""createdAt""createdAt"sortDirectionstring
The direction to sort (ascending or descending).
"asc""desc""asc"Responses
Responses
A list of jobs the current user can access is returned.
/workloads/jobsList jobs
Returns a paginated list of all jobs in the organization, including their current status, active version, and schedule information.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100Responses
Responses
The list of LakeSail jobs is returned.
/workloads/jobsCreate a job
Defines a new job within the organization. The job is created with an initial published version containing the provided configuration, including the target cluster, schedule, and query assignments. Requires an active cluster and at least one team.
Request Body
Responses
Responses
The LakeSail job was created successfully.
/workloads/jobs/{job}Describe a job
Returns the full details of a job, including its current active version configuration, schedule, and associated cluster and query information.
Parameters
jobrequired
A LakeSail job ID.
Responses
Responses
Job details with normalized entity references
/workloads/jobs/{job}Delete a job
Permanently removes a job and all its associated versions, runs, and team assignments. Active or pending runs are cancelled before deletion.
Parameters
jobrequired
A LakeSail job ID.
Responses
Responses
The requested operation was done successfully.
/workloads/jobs/{job}Update a job
Modifies a job's metadata such as its name or description. To change execution configuration (cluster, schedule, queries), create a new version using the versioning endpoints instead.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The LakeSail job was updated successfully.
/workloads/jobs/{job}/activate-versionActivate a job version
Changes the job's active configuration to a previously published version.
The target version must exist and be published. Any existing draft version
must be discarded or published before activating a different version.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The specified version was activated successfully.
/workloads/jobs/{job}/draftDescribe the draft version of a job
Returns the current draft version for the specified job.
Returns 404 if no draft version exists.
Parameters
jobrequired
A LakeSail job ID.
Responses
Responses
The draft version details.
/workloads/jobs/{job}/draftCreate a new draft version for a job
Creates a new draft version by copying the currently published version's
configuration. Fields provided in the request body override the copied values.
A job can have at most one draft version at a time. If a draft already exists,
returns 409 Conflict.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
A new draft version was created successfully.
/workloads/jobs/{job}/draftDiscard the draft version of a job
Discards (deletes) the current draft version without publishing it.
The job continues running its current published version unchanged.
Returns 404 if no draft version exists.
Parameters
jobrequired
A LakeSail job ID.
Responses
Responses
The draft version was discarded successfully.
/workloads/jobs/{job}/draftUpdate the draft version of a job
Updates fields on the current draft version. Only provided fields are modified;
omitted fields retain their current values. Returns 404 if no draft version exists.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The draft version was updated successfully.
/workloads/jobs/{job}/draft/publishPublish the draft version of a job
Publishes the current draft version, making it the new active configuration.
The draft version's status changes to 'published' and the job's version pointer
is updated. Returns 400 if no draft version exists, 404 if the job does not exist.
Parameters
jobrequired
A LakeSail job ID.
Responses
Responses
The draft version was published successfully.
/workloads/jobs/{job}/teamsList job teams
Returns the teams that have been granted access to the specified job.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100Responses
Responses
The list of teams associated with the job is returned.
/workloads/jobs/{job}/teamsAdd teams to a job
Grants one or more teams access to a job. Team members inherit the ability to view the job and its runs based on their team role permissions.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The teams were added to the job successfully.
/workloads/jobs/{job}/teams/{team}Remove a team from a job
Revokes a team's access to a job. Team members will no longer be able to view or interact with the job unless they have access through another team.
Parameters
jobrequired
A LakeSail job ID.
teamrequired
The team ID.
Responses
Responses
The team was removed from the job successfully.
/workloads/jobs/{job}/versionsList job versions
Returns a paginated list of all published versions for a job, ordered by version number. Each version represents a point-in-time configuration snapshot.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100pageinteger
The page number to retrieve (1-indexed). Used with limit to support offset-based pagination.
"int32"11Responses
Responses
The list of LakeSail job versions is returned.
/workloads/jobs/{job}/versionsCreate a job version
Creates and publishes a new version for the job in a single request. This is
equivalent to creating a draft, updating fields, and publishing. The job must
not have an existing draft version.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The job version was created and published successfully.
/workloads/jobs/{job}/versions/{jobVersionNumber}Describe a job version
Returns the full configuration snapshot for a specific version of a job, including cluster assignment, schedule, queries, and dependency settings.
Parameters
jobrequired
A LakeSail job ID.
jobVersionNumberintegerrequired
A LakeSail job version.
"int32"1Responses
Responses
Job details for the specified version, with normalized entity references
/workloads/teams/{team}/jobsList team jobs
Returns a paginated list of jobs that the specified team has been granted access to.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100Responses
Responses
The list of LakeSail jobs accessible to the team is returned.
/workloads/clusters/{cluster}/jobsList jobs on a cluster
Returns a paginated list of jobs whose active version is configured to execute on the specified cluster.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100Responses
Responses
The list of LakeSail jobs configured to run on the cluster is returned.