---
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`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/v2/projects/{project_id}/annotation/ratings`
- Auth: one of:
  - API key in header `Galileo-API-Key`
  - API key in header `Splunk-AO-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic

## 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.dev/galileo/apis/galileo-api.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api/revisions/441b96da8c30?raw)