---
title: "Create a new Curated Snapshot."
method: POST
path: "/curatedsnapshot/v1/jobs"
tags: ["Curated Snapshots"]
---

# Create a new Curated Snapshot.

`POST /curatedsnapshot/v1/jobs`

Creates a new Curated Snapshot for the specified resource, which could be Endpoint devices, File Server, NAS, OneDrive, or SharePoint sites. VMware workloads are not supported for Curated Snapshot jobs.

## Request body

- CSJobCreationParams
  - `ssRangestartDate` string, date, required — Start date from which snapshots are considered for creation of Curated Snapshot
  - `ssRangeEndDate` string, date, required — End date till when snapshots are considered for creation of Curated Snapshot
  - `retentionPeriod` integer, required — Number of days for which Curated Snapshot is to be retained for.
  - `excludeFileExtentions` boolean — Boolean flag to include files extensions for exclusion based on the added extensions.
  - `fileExtentions` string[] — File extensions which are to be excluded from Curated Snapshot.
  - `matchCaseSensitiveExtensions` boolean — If set to true, it performs a case-sensitive comparison of excluded extensions. By default, it uses case-insensitive comparison.
  - `replaceExistingSnapshot` boolean — Flag to decide if existing Curated Snapshot should be replaced by a newer one.
  - `resources` object[]
    - `orgID` integer — The Phoenix organization ID for the resource. For inSync workloads, value will be -1.
    - `workload` 'endpoints' | 'onedrive' | 'sharepoint' | 'fileserver' | 'nas' — Specify the workload for which you want to create the Curated Snapshot
    - `resourceType` 'Endpoint' | 'OneDrive' | 'SharePoint' | 'File Server' | 'NAS' — Specify the resource type for which you want to create the Curated Snapshot
    - `resourceID` integer — ID of resource for which restore job is created in inSync.
    - `resourceName` string — Name of resource for which restore job is created in inSync. Ensure that you have entered the correct resource name associated with the resource ID mentioned in the above parameter. For example, enter Ernie Carter's Macbook if resource ID 1234 is associated with Ernie Carter's Macbook.
    - `resourceParentName` string — Name of the user's device, in case of a device, or Server Name in case of a backup set which is quarantined. Example - Ernie Carter
  - `useLightScan` boolean — Boolean flag to enable Quick Scan for Curated Snapshot creation.
  - `maxScanFileSizeLimitInMB` integer — Maximum file size limit in MB (between 100 to 1024) for Curated Snapshot creation.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — The request either did not include an authentication token, or you have provided an expired authentication token.
- `404` — The requested resource was not found.
- `500` — Internal Server Error

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)