Job run execution, monitoring, and lifecycle.
/me/jobs/runsList my job runs
Returns all job runs that the authenticated user can access based on their team memberships and role permissions.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100markerstring
The pagination token returned from the previous list operation.
Responses
Responses
The list of job runs accessible by the current user is returned.
/workloads/jobs/{job}/runsList job runs
Returns a paginated list of runs for a specific job, ordered by creation time. Includes status, timing, and trigger information for each run.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100markerstring
The pagination token returned from the previous list operation.
Responses
Responses
The list of LakeSail job runs is returned.
/workloads/jobs/{job}/runsCreate a job run
Triggers a new execution of the job using its currently active version configuration. The run is placed in a pending state until released or automatically dispatched by the scheduler.
Parameters
jobrequired
A LakeSail job ID.
Request Body
Responses
Responses
The LakeSail job run was created successfully.
/workloads/jobs/{job}/runs/{jobRun}Describe a job run
Returns the full details of a job run, including its current status, timing information, and execution results.
Parameters
jobrequired
A LakeSail job ID.
jobRunrequired
A LakeSail job run ID.
Responses
Responses
The LakeSail job run is returned.
/workloads/jobs/{job}/runs/{jobRun}Delete a job run
Permanently removes a job run record. Only completed, failed, or cancelled runs can be deleted.
Parameters
jobrequired
A LakeSail job ID.
jobRunrequired
A LakeSail job run ID.
Responses
Responses
The requested operation was done successfully.
/workloads/jobs/{job}/runs/{jobRun}/readyRelease a pending job run for execution
Transitions a job run from pending to ready, making it eligible for execution.
Use this when orchestrating job runs that were created in pending status and
should be released once their dependencies are satisfied.
Returns 409 if the run is not currently in pending status.
Responses
Responses
The job run has been released and is now in ready status.
/workloads/jobs/{job}/runs/{jobRun}/retryRetry a job run
Resets a terminal job run so it can be executed again.
The run keeps its original ID, version, parameters, and audit trail.
The run's status must be failed, timeout, or cancelled. By default
the run transitions to ready (immediately eligible for execution).
If hold is true in the request body, the run transitions to pending
instead, requiring a subsequent Release call before execution.
Returns 409 if the run is not in an allowed terminal status.
Request Body
Responses
Responses
The job run has been reset. Its status is ready (eligible for execution) or pending (held until released) depending on the hold flag in the request.