Manage and Maintain Your Snapshots

Check the Status of a Snapshot Creation

Creating a snapshot can take a while. Use the snapshot name or ID to check its creation status.

1sf org get snapshot --snapshot <name or ID> --target-dev-hub <username or alias>

For example:

1sf org get snapshot --snapshot dhsnapshot --target-dev-hub my-dev-hub

After the status changes to Active, you can use the snapshot to create scratch orgs.

1Name               Value        
2 ──────────────────  ──────────────────── 
3 Id                  0Oo1Q0000004C93SXX   
4 Snapshot Name       dhsnapshot           
5 Description         Dreamhouse app       
6 Status              Active               
7 Source Org          00D050000004ipAEXX   
8 Created Date        09/22/2023, 02:07 PM 
9 Last Modified Date  09/22/2023, 02:14 PM 
10 Expiration Date     2024-09-21           
11 Last Cloned Date                        
12 Last Cloned By Id

List All Scratch Org Snapshots

You can view all the snapshots in a Dev Hub org that you have access to. If you’re an admin, you can see all snapshots associated with the Dev Hub org. If you’re a user, you can see only your snapshots, unless a Dev Hub admin gives you View All Records permissions.

1sf org list snapshot --target-dev-hub <username or alias>

Delete a Scratch Org Snapshot

If you don’t need a snapshot anymore or run out of active snapshots, you can delete a snapshot. Dev Hub admins can delete any snapshot, while users can delete only their snapshots unless a Dev Hub admin gives the user Modify All Records permissions. Deleting a snapshot frees up a license to create an additional snapshot, but the associated data is retained for 100 days after the snapshot was created.

This example identifies the snapshot for deletion by snapshot name.

1sf org delete snapshot --snapshot dhsnapshot --target-dev-hub my-dev-hub

This example identifies the snapshot for deletion by snapshot ID.

1sf org delete snapshot --snapshot 0OoWt00000000A1BCD --target-dev-hub my-dev-hub