Copy Assessments API
The Copy Assessments API provides an endpoint to create a copy of an assessment metric type or survey definition in the Assessment Metric Type [asmt_metric_type] table.
This API is included in the Assessments and Surveys application, which is available by default.
The calling user must have the assessment_admin role.
Parent Topic:REST API reference
Copy Assessments - POST /now/copy_assessments/copy
Creates a copy of an assessment metric type or survey definition in the Assessment Metric Type [asmt_metric_type] table.
All associated questions (type), configurations, categories, metrics, domain separation rules, and role-based categories are copied. Assigned users, category users, instances, and trigger conditions are not copied.
URL format
Default URL: /api/now/copy_assessments/copy
Supported request parameters
| Name | Description |
|---|---|
| None |
| Name | Description |
|---|---|
| None |
| Name | Description |
|---|---|
| sysID | Required. Sys\_id of the assessment metric type or survey definition to copy.Table: Assessment Metric Type \[asmt\_metric\_type\] Data type: String |
Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see Supported REST API headers.
| Header | Description |
|---|---|
| Accept | Data format of the response body. Only supports application/json. |
| Content-Type | Data format of the request body. Only supports application/json. |
| Header | Description |
|---|---|
| Content-Type | Data format of the response body. Only supports application/json;charset=UTF-8. |
Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see REST API HTTP response codes.
| Status code | Description |
|---|---|
| 200 | Successful. The request was successfully processed. |
| 500 | Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error. |
Response body parameters (JSON)
| Name | Description | ||
|---|---|---|---|
| result | Details about the API request.Data type: Object | ||
| result.name | Name of the copy of the assessment metric type or survey definition. Copies are named using the format `Copy of | result.sysID | Sys\_id of the copy of the assessment metric type or survey definition.Table: Assessment Metric Type \[asmt\_metric\_type\] Data type: String | cURL requestThis example creates a copy of an assessment metric type. Response body. |