---
sourceDocument: Australia API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/api-reference

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Copy Assessments API

# Copy Assessments API {#ariaid-title1}

Release version: Australia  
Updated March 19, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://www.servicenow.com/docs/access?context=assessments-surveys-landing-page&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) application, which is available by default.

The calling user must have the assessment_admin role.

## Copy Assessments - POST /now/copy_assessments/copy {#ariaid-title2}

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

{#copy-assess-POST-copy__entry__2}

| Name | Description |
|-|-|
| None |   |
[Table 1. Path parameters]

{#copy-assess-POST-copy__entry__6}

| Name | Description |
|-|-|
| None |   |
[Table 2. Query parameters]

{#copy-assess-POST-copy__entry__10}

| 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 |
[Table 3. Request body parameters (JSON)]

### 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](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other.").
{#copy-assess-POST-copy__entry__14}{#copy-assess-POST-copy__accept-JSON-only-entry-RESTAPI}{#copy-assess-POST-copy__content_type-JSON-only-entry-RESTAPI}

| 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 4. Request headers]

{#copy-assess-POST-copy__entry__20}

| Header | Description |
|-|-|
| Content-Type | Data format of the response body. Only supports application/json;charset=UTF-8. |
[Table 5. Response headers]

### 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](https://servicenow-prod.fluidtopics.net/qh7RcF0RI6a~i9u3octdlg "REST (REpresentational State Transfer) is a simple stateless architecture that provides standards between computer systems on the web, making it easier for them to communicate with each other.").
{#copy-assess-POST-copy__entry__24}{#copy-assess-POST-copy__entry-200-status-code}{#copy-assess-POST-copy__entry-500-status-code}

| 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. |
[Table 6. Status codes]

### Response body parameters (JSON)

{#copy-assess-POST-copy__entry__30}

| 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"
      }
    }