---
title: "Apply Bulk Annotation"
method: POST
path: "/v2/projects/{project_id}/annotation/ratings"
tags: ["annotation"]
---

# Apply Bulk Annotation

`POST /v2/projects/{project_id}/annotation/ratings`

## Path parameters

- `project_id` string, uuid4, required

## Request body

- BulkAnnotationRequest
  - `operations` union[], required
    - union
      - BulkAnnotationRatingCreate
        - `explanation` string, nullable
        - `rating` union, required
          - ApiSchemasAnnotationLikeDislikeRating
            - `annotation_type` 'like_dislike'
            - `value` boolean, required
          - ApiSchemasAnnotationStarRating
            - `annotation_type` 'star'
            - `value` integer, required
          - ApiSchemasAnnotationScoreRating
            - `annotation_type` 'score'
            - `value` integer, required
          - ApiSchemasAnnotationTagsRating
            - `annotation_type` 'tags'
            - `value` string[], required
          - ApiSchemasAnnotationTextRating
            - `annotation_type` 'text'
            - `value` string, required
          - ApiSchemasAnnotationChoiceRating
            - `annotation_type` 'choice'
            - `value` string, required
          - ApiSchemasAnnotationTreeChoiceRating
            - `annotation_type` 'tree_choice'
            - `value` string, required
        - `annotation_template_id` string, uuid4, required
        - `operation_type` 'create'
      - BulkAnnotationRatingDelete
        - `annotation_template_id` string, uuid4, required
        - `operation_type` 'delete'
  - `selector` AnnotationTraceSelector, required — Choose specific traces to apply the bulk operation to.
    - `selector_type` 'traces'
    - `traces` string[], required

## Response `200`

Successful Response

- BulkAnnotationRatingStatus[]
  - `selector` 'traces'
  - `index` integer, nullable
  - `trace` string, uuid4, nullable
  - `operation` 'create' | 'delete', required — Operation type for bulk annotation rating operations.
  - `success` boolean, required
  - `message` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)