SandboxProcess | Tooling API | Salesforce Developers

When you create a SandboxInfo record, a corresponding SandboxProcess record is created. The latest SandboxProcess record for a SandboxInfo record represents the current state of the sandbox.

This object is available in API version 35.0 and later.

Supported SOAP Calls

query(), retrieve(), update()

Supported REST HTTP Methods

GET, PATCH

Fields

Except for RefreshAction, all fields are read only. The read-only fields represent the attributes chosen on SandboxInfo when a copy process was enqueued, or represent the state of the process for monitoring purposes.

Field	Details
ActivatedById	Type reference Properties Filter, Group, Nillable, Sort Description A reference to the ID of the user who requested sandbox activation. Relationship Name ActivatedBy Relationship Type Lookup Refers To User
ActivatedDate	Type dateTime Properties Filter, Nillable, Sort Description Represents when the sandbox was activated during a refresh.
ActivationUserGroupId	Type reference Properties Filter, Group, Nillable, Sort, Update Description A reference to the ID of the group consisting of users who can access the sandbox. The user who created the sandbox is added to the group by default. Available in API version 60.0 and later. This field is a relationship field. Relationship Name ActivationUserGroup Relationship Type Lookup Refers To Group
ApexClassId	Type reference Properties Filter, Group, Nillable, Sort Description A reference to the ID of an Apex class to run after each copy of the sandbox. Running this class allows you to perform DML operations on the sandbox to prepare it for use. The class must extend the `System.SandboxPostCopy` interface. Available in API version 36.0 and later. Relationship Name ApexClass Relationship Type Lookup Refers To ApexClass
AutoActivate	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Represents whether the sandbox refresh is configured to activate immediately upon completion.
CopyArchivedActivities	Type boolean Properties Defaulted on create, Filter, Group, Sort Description If `true`, archived activity data is copied to the sandbox. Restrictions This field is visible only if your organization has purchased an option to copy archived activities for sandbox. To obtain this option, contact Salesforce Customer Support. You can set the value to `true` only for a Full sandbox.
CopyChatter	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Represents whether archived Chatter data is copied to the sandbox.
CopyProgress	Type int Properties Filter, Group, Nillable, Sort Description Represents how much of a copy has been completed. Available for Developer, Developer Pro, and Full sandboxes. Not available for Full or Partial sandboxes created from sandbox templates.
Description	Type string Properties Filter, Nillable, Sort Description A description of the sandbox, which helps you distinguish it from other sandboxes.
EndDate	Type dateTime Properties Filter, Nillable, Sort Description Represents when the sandbox copy process finished.
Features	Type textarea Properties Nillable, Update Description The list of add-on features to apply after the sandbox is created or refreshed. Currently there’s one valid value: `['SandboxStorage']`: Increases the data storage available for Developer sandboxes from 200 MB to 400 MB and Developer Pro sandboxes from 1 GB to 2 GB. You can’t use this feature with Partial Copy or Full sandboxes.
HistoryDays	Type int Properties Defaulted on create, Filter, Group, Sort Description Represents the number of days of object history to be copied in the sandbox. Valid values: `-1`, which means all available days `0` `10` `20` `30` `60` `90` `120` `150` `180`
LicenseType	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The sandbox license type. Valid values: `ADVANCED_DEV` `ADVANCED_FULL` `DEVELOPER` `DEVELOPER_PRO` `PARTIAL` `FULL` `FULL_PLUS`
RefreshAction	Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort, Update Description Editing this field activates or discards a sandbox refresh. Valid values: `ACTIVATE` `DISCARD` Restrictions If all the following are true, you can activate or discard a sandbox refresh by editing the value in this field. This record is the latest SandboxProcess record. The associated sandbox has been refreshed. This record’s Status is `Pending Activation`.
SandboxInfoId	Type reference Properties Filter, Group, Nillable, Sort Description A reference to the ID of the SandboxInfo being processed (create or refresh). Relationship Name SandboxInfo Relationship Type Lookup Refers To SandboxInfo
SandboxName	Type string Properties Filter, Group, idLookup, Sort Description The name of the sandbox.
SandboxOrganization	Type string Properties Filter, Group, Nillable, Sort Description The ID of the org created by the copy process. This field is available in API version 37.0 and later.
SourceId	Type reference Properties Filter, Group, Nillable, Sort, Update Description A reference to the ID of the SandboxInfo that this sandbox is a clone of. This field is used only when cloning a sandbox. When this field is used, LicenseType must be null. Your source sandbox must be an existing, completed sandbox, that belongs to the same production org as the sandbox you’re creating or refreshing. Your SourceId value can’t be the same SandboxInfo that you’re updating. Available in API version 37.0 and later. Relationship Name Source Relationship Type Lookup Refers To SandboxInfo
StartDate	Type dateTime Properties Filter, Nillable, Sort Description Represents when the sandbox copy process started.
Status	Type string Properties Filter, Group, Nillable, Sort Description Current state of the sandbox copy process. If running a SOQL query, use the values in parentheses. Possible values include: Activating Activation Confirmed (5) Deactivation Confirmed (6) Deactivation Finished (7) Activation Processing (8) Completed (1) Deleted (D) Deleting (E) Discarding (F) Locked (B) Locking (L) Pending (0) Pending Activation (4) Processing (2) Sampling (X) Stopped (G) Suspended (S)
TemplateId	Type reference Properties Filter, Group, Nillable, Sort Description A reference to the ID of the PartitionLevelScheme that represents the sandbox template associated with the sandbox for this process. A sandbox template selects which objects to copy in a sandbox. Relationship Name Template Relationship Type Lookup Refers To PartitionLevelScheme

Usage

SandboxInfo represents a sandbox, and SandboxProcess represents the sandbox copy process, which occurs when you create a sandbox or refresh it. You can also delete a sandbox.

Creating a Sandbox

To enqueue a new sandbox:

Create a SandboxInfo record.
To find the status of a sandbox after it is enqueued, query SandboxProcess for a given SandboxInfoId field to find the latest SandboxProcess record. The value of Completed in Status indicates that the creation process is finished.

Refreshing a Sandbox

To refresh a sandbox:

To start a sandbox refresh, edit the SandboxInfo record.
To find the status of a sandbox after it is enqueued, find the latest SandboxProcess record by querying SandboxProcess for a given SandboxInfoId value. The value of Status indicates the current state of the process.
When the Status field value is Pending Activation, change the value of the RefreshAction field to either ACTIVATE or DISCARD.

Deleting a Sandbox

To delete a sandbox, delete the SandboxInfo record that represents the sandbox. Deleting the SandboxInfo record deletes the sandbox and frees up a license.

Login

Products

Experiences

Agentforce

Sales

Service

Marketing

Commerce

Analytics

Slack

Net Zero

Small Business

Data

Salesforce Platform

Customer Success

Partner Apps & Experts

Discover the #1 AI CRM

Discover the #1 AI CRM

Automotive

Communications

Engineering, Construction & Real Estate

Consumer Goods

Education

Energy & Utilities

Financial Services

Healthcare & Life Sciences

Manufacturing

Media

Nonprofit

Professional Services

Public Sector

Retail

Technology

Travel, Transportation & Hospitality

Explore Salesforce for industries.

Explore Salesforce for industries.

Customer Stories

Salesforce on Salesforce Stories

Trailblazer Stories

Explore success stories.

Explore success stories.

Learning on Trailhead

Events

Resources

Blogs

Become a Trailblazer.

Become a Trailblazer.

Help & Documentation

Communities

Services & Plans

Account Management

Questions? We can help.

Questions? We can help.

About Salesforce

Our Values

Our Impact

Careers

Newsroom

Legal

More Salesforce Brands

Hear our story.

Hear our story.

Events

My List

Explore Salesforce+.

Explore Salesforce+.

Login

Products

Experiences

Contact Us

By phone

Online

Products

Experiences

Developer Centers

Salesforce Platform

Industries

Resources

Developer Tools

Build Skills