---
updatedAt: 2026-05-27T12:48:32.000Z
agentTools:
  projectIndex: https://developer.onetrust.com/onetrust/llms.txt
---

# Update Assessment Tags

Use this API to update the tags associated with a specific assessment. The tags submitted through this API will overwrite all existing tags on the assessment. 

 > 🗒 Things to Know  
 > 
 > - The [Get Assessment](/onetrust/reference/exportassessmentusingget) API can be used to retrieve the current list of assessment tags for the specified assessment. You can include these tags within the request of this API to keep them on the assessment.
 >
 > - New tags can be created using this API and can then be associated with an assessment.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Privacy Automation - Assessment Automation",
    "version": "1.0",
    "contact": {
      "name": "OneTrust Support",
      "url": "https://my.onetrust.com/s/contactsupport"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "description": "The Assessment Automation APIs provide functionality for managing assessment template lifecycle operations, including template export and import for cross-environment migration, retrieving published template metadata with filtering by template type, and template deletion with comprehensive validation checks."
  },
  "servers": [
    {
      "url": "https://{hostname}",
      "variables": {
        "hostname": {
          "default": "hostname",
          "description": "The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com."
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Assessment Management",
      "description": "The Assessment Management APIs are used to modify, link, and manage existing assessments.",
      "externalDocs": {
        "description": "OpenAPI 3.1.0 - Download Definition",
        "url": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-assessment-automation.json"
      },
      "x-displayName": "Assessment Management"
    }
  ],
  "paths": {
    "/api/assessment/v2/assessments/{assessmentId}/tags": {
      "put": {
        "operationId": "addOrUpdateTagsUsingPUT",
        "summary": "Update Assessment Tags",
        "description": "Use this API to update the tags associated with a specific assessment. The tags submitted through this API will overwrite all existing tags on the assessment. \n\n > 🗒 Things to Know  \n > \n > - The [Get Assessment](/onetrust/reference/exportassessmentusingget) API can be used to retrieve the current list of assessment tags for the specified assessment. You can include these tags within the request of this API to keep them on the assessment.\n >\n > - New tags can be created using this API and can then be associated with an assessment.\n",
        "tags": [
          "Assessment Management"
        ],
        "x-onetrust": {
          "spec-label": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-assessment-automation.json"
        },
        "parameters": [
          {
            "name": "assessmentId",
            "in": "path",
            "description": "UUID of the assessment to update tags for",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "550e8400-e29b-41d4-a716-446655440000"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "examples": {
                "Tags": {
                  "description": "Tags",
                  "value": [
                    "GDPR",
                    "SIG",
                    "tag3"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "429": {
            "description": "Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).",
            "headers": {
              "Retry-After": {
                "schema": {
                  "description": "The number of seconds after which requests will be allowed again.",
                  "format": "int32"
                }
              },
              "ot-period": {
                "schema": {
                  "description": "The unit of time for which the rate limit applies",
                  "enum": [
                    "HOUR",
                    "MINUTE"
                  ]
                }
              },
              "ot-ratelimit-event-id": {
                "schema": {
                  "description": "The unique identifier for the rate-limiting event.",
                  "format": "uuid"
                }
              },
              "ot-request-made": {
                "schema": {
                  "description": "The number of requests made within the specified period.",
                  "format": "int32"
                }
              },
              "ot-requests-allowed": {
                "schema": {
                  "description": "The number of requests allowed within the specified period.",
                  "format": "int32"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "PrivacyAutomation-AssessmentAutomation_OAUTH2": [
              "ASSESSMENT"
            ]
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "PrivacyAutomation-AssessmentAutomation_OAUTH2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://{hostname}/api/access/v1/oauth/token",
            "scopes": {
              "ASSESSMENT": "Access to assessment scope for external systems",
              "ASSESSMENT_READ": "Access to read assessment scope for external systems"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "metrics-enabled": false
  },
  "x-onetrust": {
    "spec-label": "OpenAPI 3.1.0"
  }
}
```

# Sibling pages

* [Archive Assessment](https://developer.onetrust.com/onetrust/reference/archiveassessmentsusingput.md)
* [Link Assessments](https://developer.onetrust.com/onetrust/reference/addmanualassessmentlinksusingpost.md)
* [Set Primary Record](https://developer.onetrust.com/onetrust/reference/updateprimaryrecordusingput.md)
* [Modify Assessment](https://developer.onetrust.com/onetrust/reference/updatebasicassessmentdetailsusingpatch.md)
* [Unarchive Assessment](https://developer.onetrust.com/onetrust/reference/unarchiveassessmentsusingput-1.md)
* [Move Assessment to Recycle Bin](https://developer.onetrust.com/onetrust/reference/softdeleteassessmentusingput.md)