---
schema_version: "1"
id: 98d77de9c65cc5f8d4b8927bdae44abe5ffe350811f536aa07778d37b52f09b4
title: DevopsTestSuiteExecution
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_devopstestsuiteexecution.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_devopstestsuiteexecution.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9a06372863736dd457eadfe757f72a06e812cebd8c1fad642a7af10e739f58f8
description: Records the individual execution lifecycle, results, and metrics of a specific test suite within a DevOps pipeline stage. It tracks granular outcomes like code coverage, pass/fail rates, and links directly back to the overarching test suite group. This object is available in API version 67.0 and later.
---
# DevopsTestSuiteExecution

Records the individual execution lifecycle, results, and metrics of a specific test suite within a DevOps pipeline stage. It tracks granular outcomes like code coverage, pass/fail rates, and links directly back to the overarching test suite group. This object is available in API version 67.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

| Field | Details |
| --- | --- |
| Coverage | 
Type

percent

Properties

Create, Filter, Nillable, Sort, Update

Description

The automated code coverage percentage for example, Apex test coverage, achieved during this specific test suite execution.



 |
| DevopsTestSuiteGroupExecId | 

Type

reference

Properties

Create, Filter, Group, Sort, Update

Description

References the parent DevopsTestSuiteGroupExec record that coordinates this and other related test suite executions within the pipeline stage.

Relationship Name

DevopsTestSuiteGroupExec

Refers To

DevopsTestSuiteGroupExec



 |
| DevopsTestSuiteId | 

Type

reference

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

References the definition of the DevopsTestSuite being executed.

This field is a relationship field.

Relationship Name

DevopsTestSuite

Refers To

DevopsTestSuite



 |
| DevopsTestSuiteStageId | 

Type

reference

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

References the specific stage configuration or environment step (DevopsTestSuiteStage) where this execution takes place.

This field is a relationship field.

Relationship Name

DevopsTestSuiteStage

Refers To

DevopsTestSuiteStage



 |
| ExecutionEndTime | 

Type

dateTime

Properties

Create, Filter, Nillable, Sort, Update

Description

The date and time when the test suite finished executing. This field remains null while the execution is actively InProgress.



 |
| ExecutionStartTime | 

Type

dateTime

Properties

Create, Filter, Sort, Update

Description

The precise date and time when the execution of this test suite commenced.



 |
| ExternalIdRef | 

Type

string

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

A unique identifier used to map or reference this test run to an external CI/CD engine, testing framework, or third-party tool execution ID.



 |
| FailureCount | 

Type

int

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

The total number of individual test cases or assertions that failed during this test suite run.



 |
| FailureRate | 

Type

percent

Properties

Create, Filter, Nillable, Sort, Update

Description

The calculated percentage of failed tests relative to the total number of tests run in this suite.



 |
| LastReferencedDate | 

Type

dateTime

Properties

Filter, Nillable, Sort

Description

The timestamp when the current user last accessed this record indirectly, such as through a related list or lookup context.



 |
| LastViewedDate | 

Type

dateTime

Properties

Filter, Nillable, Sort

Description

The timestamp when the current user last explicitly viewed this record's detail page or list view.



 |
| LearnMore | 

Type

url

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

A URL pointing to supplemental documentation, internal run logs, or troubleshooting guides relevant to this test suite execution.



 |
| Name | 

Type

string

Properties

Autonumber, Defaulted on create, Filter, idLookup, Sort

Description

A system-generated unique auto-number identifier assigned to the test suite execution record.



 |
| OwnerId | 

Type

reference

Properties

Create, Defaulted on create, Filter, Group, Sort, Update

Description

Identifies the user or queue that owns this specific test suite execution record.

Relationship Name

Owner

Refers To

Group, User



 |
| QualityGateStatus | 

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

Description

Represents the final evaluation outcome of any automated quality policies or compliance criteria established for this test suite.

Possible values are:

- Error
- Failed
- InProgress
- Passed

The default value is Passed.



 |
| ReportUrl | 

Type

url

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

The web link to the complete, detailed test execution report or artifacts (e.g., JUnit XML, HTML dashboard) generated by the runner.



 |
| ResultDetails | 

Type

textarea

Properties

Create, Nillable, Update

Description

A raw block of summary text, error logs, stack traces, or console output detailing why a test failed or stalled.



 |
| Status | 

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update

Description

The operational state of the test suite run execution process itself.

Possible values are:

- Error
- Failed
- InProgress
- Passed

The default value is Passed.



 |
| SuccessCount | 

Type

int

Properties

Create, Filter, Group, Nillable, Sort, Update

Description

The total number of individual test cases or assertions that completed successfully without errors.



 |
| SuccessRate | 

Type

percent

Properties

Create, Filter, Nillable, Sort, Update

Description

The calculated percentage of passing tests relative to the total number of tests run in this suite.



 |