lookup_jobs_in_build
Retrieve and filter jobs from a specific Sauce Labs build to analyze test execution status, completion, errors, and performance across real devices or emulators.
Instructions
Returns information about all jobs associated with the specified build. You can limit which jobs are
returned using any of the optional filtering parameters.
:param build_source: Required. The type of test device associated with the build and its jobs. Valid values are:
rdc - Real Device Builds, vdc - Emulator or Simulator Builds
:param build_id: Required. The unique identifier of the build whose jobs you are looking up. You can look up
build IDs in your organization using the Lookup Builds endpoint.
:param modified_since: Optional. Returns only jobs that have been modified after this unicode timestamp.
:param completed: Optional. Returns jobs based on whether they completed, meaning the tests ran uninterrupted to
completion: true - Return jobs that have a completed state of true, false - Return jobs that have a
completed state of false.
:param errored: Optional. Returns jobs based on their errored state: true - Return jobs that have an errored
state of true, false - Return jobs that have an errored state of false.
:param failed: Optional. Returns jobs based on their failed state: true - Return jobs that have a failed state
of true, false - Return jobs that have a failed state of false.
:param finished: Optional. Returns jobs based on whether they have finished, meaning they are no longer
running, but may not have run to completion: true - Return jobs that have a finished state of true, false -
Return jobs that have a finished state of false.
:param new: Optional. Returns jobs based on their new state: true - Return jobs that have a new state of true,
false - Return jobs that have a new state of false.
:param passed: Optional. Returns jobs based on their passed state: true - Return jobs that have a passed state
of true, false - Return jobs that have a passed state of false.
:param public: Optional. Returns jobs based on whether they were run on public devices: true - Return jobs that
have a public state of true, false - Return jobs that have a public state of false.
:param queued: Optional. Returns jobs based on whether their current state is queued: true - Return jobs that
have a queued state of true, false - Return jobs that have a queued state of false.
:param running: Optional. Returns jobs based on whether they are currently in a running state: true - Return
jobs that are currently running, false - Return jobs that are not currently running.
:param faulty: Optional. Returns jobs based on whether they are identified as faulty, meaning either errored or
failed state is true. true - Return jobs that have a faulty state of true, false - Return jobs that have a
faulty state of false.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| build_source | Yes | ||
| build_id | Yes | ||
| modified_since | No | ||
| completed | No | ||
| errored | No | ||
| failed | No | ||
| finished | No | ||
| new | No | ||
| passed | No | ||
| public | No | ||
| queued | No | ||
| running | No | ||
| faulty | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |