--- schema_version: "1" id: 816a08d7e39e66e962b56a1a5206b5a476654e7ded031704ada14bacc5f1cbb0 title: ChangeRequest collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_changerequest.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_changerequest.htm source_site: developer.salesforce.com content_type: documentation content_hash: aeb48a25de93ab053553a213de7621076388b8515360f067ec431610b15209dc description: Represents a decision to implement a formal request for a change (RFC). This object is available in API version 53.0 and later. --- # ChangeRequest Represents a decision to implement a formal request for a change (RFC). This object is available in API version 53.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | BusinessJustification | Type textarea Properties Create, Nillable, Update Description A description of the business reason to implement the change. This field can store up to 32 KB of data, but only the first 255 characters display in reports. | | BusinessReason | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The core reason for creating the change request. Possible values are: - t2 | | Category | Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The type of change request. Administrators set field values. | | ChangeRequestNumber | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The unique, system-generated change request number. | | ChangeType | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of change request. Administrators set field values. Possible values are: - Emergency - Major - Normal - Standard | | Description | Type textarea Properties Create, Nillable, Update Description A description of the change request. This field can store up to 32 KB of data, but only the first 255 characters display in reports. | | EstimatedEndTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time (in UTC) when the change request is estimated to be implemented. | | EstimatedStartTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The estimated date and time (in UTC) when the change request is implemented. | | FinalReviewDateTime | Type dateTime Properties Create, Filter, Nillable, Sort, Update Description The date and time (in UTC) when the change request was reviewed. | | FinalReviewNotes | Type textarea Properties Create, Nillable, Update Description Notes left by the change request reviewer. This field can store up to 32 KB of data, but only the first 255 characters display in reports. | | Impact | Type picklist Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Shows the impact of a requested change. Possible values are: - High - Low - Medium The default value is 'High'. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record, a record related to this record, or a list view. | | 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, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description A polymorphic relationship field that represents the user or group assigned as the change reviewer. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | Priority | Type picklist Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The impact and urgency of a requested change. Possible values are: - Critical - High - Low - Moderate The default value is 'Critical'. | | RemediationPlan | Type textarea Properties Create, Nillable, Update Description A description of the steps required to resolve the incident. This field can store up to 32 KB of data, but only the first 255 characters display in reports. | | ReviewerId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the user who reviewed the change request. This is a relationship field. Relationship Name Reviewer Relationship Type Lookup Refers To User | | RiskImpactAnalysis | Type textarea Properties Create, Nillable, Update Description An assessment of the risk involved with the implementation of the change request. Administrators set field values, and each value can have up to 20 characters. | | RiskLevel | Type picklist Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The risk level associated with adopting the requested change. Possible values are: - High - Low - Medium The default value is 'High'. | | Status | Type picklist Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Represents any custom or granular stages a customer may want to track. This will be a dependent picklist. Possible values are: - Approved - Canceled - Closed - Implementing - New - Open - Planning - Rejected - Reviewed - Scheduled The default value is 'New'. | | StatusCode | Type picklist Properties Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort Description The status of the change. Possible values are: - Approved - Canceled - Closed - Implementing - New - Open - Planning - Rejected - Reviewed - Scheduled The default value is 'New'. | | Subject | Type string Properties Create, Filter, Group, Sort, Update Description A brief description of the requested change. | ## 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. [ChangeRequestChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 59.0) Change events are available for the object. [ChangeRequestFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [ChangeRequestHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [ChangeRequestOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [ChangeRequestShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.