Copy Assessments API

  • Release version: Australia
  • Updated March 19, 2026
  • 1 minute to read

    • 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.

    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

    Table 1. Path parameters
    Name Description
    None
    Table 2. Query parameters
    Name Description
    None
    Table 3. Request body parameters (JSON)
    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.

    Table 4. Request 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.
    Table 5. Response headers
    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.

    Table 6. Status 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": "String",
   "sysID": "String"
}
    result.name Name of the copy of the assessment metric type or survey definition. Copies are named using the format Copy of <original name>.

    Data type: String
    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 request

    This example creates a copy of an assessment metric type.

    curl "https://instance.service-now.com/api/now/copy_assessments/copy" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"sysID\":\"d2fbde248f033300e7e16c7827bdee11\"}" \
--user 'username':'password'

    Response body.

    {
  "result": {
    "sysID": "19d54d2447f336d027d48b41516d43ee",
    "name": "Copy of Assessment: Basic flow"
  }
}