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

# Create a new Curated Snapshot.

`POST /curatedsnapshot/v1/jobs`

## Request

- Base URL: `https://apis.druva.com/realize`
- URL: `https://apis.druva.com/realize/curatedsnapshot/v1/jobs`
- Auth: API key in header `Authorization`

Creates a new Curated Snapshot for the specified resource, which could be Endpoint devices, OneDrive, SharePoint sites, File Server, or NAS.

## 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` Resource[]
    - `orgID` integer: Phoenix Organization ID in case of Phoenix Servers.
    - `workload` 'fileserver' | 'nas' | 'endpoints' | 'onedrive' | 'sharepoint': Specify the workload for which you want to create the Curated Snapshot
    - `resourceType` 'Endpoint' | 'File Server' | 'NAS' | 'OneDrive' | 'SharePoint': 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 or Phoenix.
    - `resourceName` string: Name of the resource for which the restore job is created in inSync or Phoenix. 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 the 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

- CSJobCreationResponse
  - `jobIDs` integer[]: The jobs started for Curated Snapshot creation.
  - `errorList` JobCreationError[]: List of resources for which an error was encountered during job creation.
    - `resource` Resource
      - `orgID` integer: Phoenix Organization ID in case of Phoenix Servers.
      - `workload` 'fileserver' | 'nas' | 'endpoints' | 'onedrive' | 'sharepoint': Specify the workload for which you want to create the Curated Snapshot
      - `resourceType` 'Endpoint' | 'File Server' | 'NAS' | 'OneDrive' | 'SharePoint': 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 or Phoenix.
      - `resourceName` string: Name of the resource for which the restore job is created in inSync or Phoenix. 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 the 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
    - `error` JobModelError
      - `errorCode` string: Error code seen when Curated Snapshot job could not be created.
      - `errorMessage` string: Error message seen when Curated Snapshot job could not be created.
      - `errorDescription` string: Detailed error description explaining the error when Curated Snapshot job could not be created.

## 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.dev/druva/apis/cyber-resilience.md) - [All operations](https://skmtc.dev/druva/apis/cyber-resilience/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/cyber-resilience/revisions/b149d46c996a?raw)