Use case: Update annotation status

Before you start

Before you update annotation status, ensure you have completed the following prerequisites:

  1. Verify Permissions: Confirm that you have the necessary rights to modify the annotation. Typically, you'll need to be the original creator of the annotation or have appropriate administrative permissions.
  2. Identify the Annotation: Locate the specific annotation you want to update. You'll need its unique identifier to perform this action.
  3. Determine Required Changes: Clearly identify to which status annotation needs to be updated.

How do I...?

Update the content of an annotation

To modify the text or main content of an existing annotation:

  1. Obtain the Project Identifier: Ensure you have the correct project identifier (GUID) for the project.
  2. Obtain the Annotation Identifier: Ensure you have the correct annotation identifier (GUID) for the annotation to amend.
  3. Modify the Content: Update the annotation content with new status.
  4. Handle Any Errors: Implement the appropriate error handling to manage cases where the update might fail.

Example:

var status = UpdateAnnotationStatus.Active; // Example status, adjust as needed;

await annotationManagement.UpdateAnnotationStatusAsync(
    projectId: projectId,
    annotationId: annotationId,
    updateAnnotationStatus: status,
    cancellationToken: cancellationToken);

For more information on managing annotations, see the documentation on creating annotations, updating annotation and searching annotations.