Stay organized with collections
Save and categorize content based on your preferences.
Full name: projects.locations.datasets.annotationStores.annotations.create
Creates a new Annotation record. It is valid to create Annotation objects for the same source more than once since a unique ID is assigned to each record by this service.
HTTP request
POST https://healthcare.googleapis.com/v1beta1/{parent=projects/*/locations/*/datasets/*/annotationStores/*}/annotations
Required. The name of the Annotation store this annotation belongs to. For example, projects/my-project/locations/us-central1/datasets/mydataset/annotationStores/myannotationstore.
Authorization requires the following IAM permission on the specified resource parent:
healthcare.annotations.create
Request body
The request body contains an instance of Annotation.
Response body
If successful, the response body contains a newly created instance of Annotation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis API endpoint \u003ccode\u003eprojects.locations.datasets.annotationStores.annotations.create\u003c/code\u003e allows the creation of a new Annotation record within a specified annotation store.\u003c/p\u003e\n"],["\u003cp\u003eEach Annotation created, even for the same source, receives a unique ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL uses gRPC Transcoding syntax and requires a \u003ccode\u003eparent\u003c/code\u003e parameter indicating the annotation store's location.\u003c/p\u003e\n"],["\u003cp\u003eTo use this feature, the request needs to be authorized with either the \u003ccode\u003ehealthcare.annotations.create\u003c/code\u003e IAM permission or one of the listed OAuth scopes.\u003c/p\u003e\n"],["\u003cp\u003eThe endpoint accepts an Annotation object within the request body and returns the newly created Annotation in the response body upon success.\u003c/p\u003e\n"]]],[],null,["# Method: annotations.create\n\n**Full name**: projects.locations.datasets.annotationStores.annotations.create\n\nCreates a new [Annotation](/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.annotationStores.annotations#Annotation) record. It is valid to create Annotation objects for the same source more than once since a unique ID is assigned to each record by this service.\n\n### HTTP request\n\n`POST https://healthcare.googleapis.com/v1beta1/{parent=projects/*/locations/*/datasets/*/annotationStores/*}/annotations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [Annotation](/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.annotationStores.annotations#Annotation).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Annotation](/healthcare-api/docs/reference/rest/v1beta1/projects.locations.datasets.annotationStores.annotations#Annotation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-healthcare`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
