--- schema_version: "1" id: 0b66acd03679ba3175b63dc631381c061bff65793fee992ea6e17b4c974e9c49 title: DevopsPipelnStgProm collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_devopspipelnstgprom.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_devopspipelnstgprom.htm source_site: developer.salesforce.com content_type: documentation content_hash: a0edcdab14a87c4694571c9c5ea6edee303c4e324c6840bcac08344f5dd05781 description: Represents a stage promotion in Lifecycle Center. Stage promotion moves one or more work items to the next stage in the pipeline. This object is available in API version 66.0 and later. --- # DevopsPipelnStgProm Represents a stage promotion in Lifecycle Center. Stage promotion moves one or more work items to the next stage in the pipeline. This object is available in API version 66.0 and later. ## Supported Calls create(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), update(), upsert() ## Fields | Field | Details | | --- | --- | | CompletionDate | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time when the stage promotion operation was completed. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view indirectly. | | Name | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description A unique name for the pipeline stage promotion record. | | PipelineStageId | Type reference Properties Create, Filter, Group, Sort Description The ID of the target pipeline stage to which the work items are promoted. This field is a relationship field. Relationship Name PipelineStage Relationship Type Master-detail Refers To DevopsPipelineStage (the parent object) | | RequestInfoId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the associated DevopsRequestInfo record that tracks this event. This field is a relationship field. Relationship Name RequestInfo Refers To DevopsRequestInfo | | Status | Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description The current state of the promotion operation. Possible values are: - CANCELLED - ERROR - FINALIZING - INTERRUPTED - IN\_PROGRESS - NEW - SUCCESS The default value is NEW. | ## Usage Use this object to track the execution and outcome of a stage promotion. During promotion, work item branches merge into a target stage branch and deploys the associated metadata and configuration data to the environment linked to that stage. ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [DevopsPipelnStgPromChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm) Change events are available for the object. [DevopsPipelnStgPromFeed](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm) Feed tracking is available for the object. [DevopsPipelnStgPromHistory](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm) History is available for tracked fields of the object. [DevopsPipelnStgPromOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm) Sharing rules are available for the object. [DevopsPipelnStgPromShare](https://developer.salesforce.com/docs/atlas.en-us.264.0.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm) Sharing is available for the object. #### See Also - [DevopsPipelineStage](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_devopspipelinestage.htm "Represents a connection between a pipeline, an environment, and the source control branch used for that stage. The collection of all pipeline stages in a project make up the Lifecycle Center pipeline. This object is available in API version 66.0 and later.") - [DevopsPipelnStgPromWkItem](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_devopspipelnstgpromwkitem.htm "Represents the association between a work item and a pipeline stage promotion. The object tracks the merge status of the work item into the target stage branch in source control. This object is available in API version 66.0 and later.") - [DevopsRequestInfo](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_devopsrequestinfo.htm "Represents a specific request for a Lifecycle Center operation, such as a commit, deploy, promotion, rebase, or back sync, and tracks its overall status and outcome. This object is available in API version 66.0 and later.")