---
title: "POST /tracer/bulk-annotation/"
method: POST
path: "/tracer/bulk-annotation/"
tags: ["tracer"]
---

# POST /tracer/bulk-annotation/

`POST /tracer/bulk-annotation/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/bulk-annotation/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- BulkAnnotationRequest
  - `records` BulkAnnotationRecordRequest[], required
    - `observation_span_id` string, required
    - `annotations` BulkAnnotationAnnotationRequest[]
      - `annotation_label_id` string, uuid, required
      - `value` string
      - `value_float` number
      - `value_bool` boolean
      - `value_str_list` string[]
    - `notes` BulkAnnotationNoteRequest[]
      - `text` string, required

## Response `200`

OK

- BulkAnnotationResponse
  - `status` boolean
  - `result` BulkAnnotationResponseResult, required
    - `message` string, required
    - `annotations_created` integer, required
    - `annotations_updated` integer, required
    - `notes_created` integer, required
    - `succeeded_count` integer, required
    - `errors_count` integer, required
    - `warnings_count` integer, required
    - `warnings` object[], nullable
    - `errors` object[], nullable

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)