Annotate a batch of dataset examples

Write human annotations to a batch of examples in a dataset.

Idempotency: Writes use upsert semantics — submitting the same annotation config name for the same example overwrites the previous value. Retrying on network failure will not create duplicates.

Unmatched record IDs: If a record_id does not correspond to an existing example in the dataset, the annotation for that record is silently ignored. The response will still include an entry for it. No error is returned.

Payload Requirements

• dataset_id is the path parameter for the target dataset.
• annotations is a list of per-example annotation inputs, each identified by record_id.
• Annotation names must match existing annotation configs in the dataset’s space.
• Up to 500 examples may be annotated per request.

Valid example

{
  "annotations": [
    {"record_id": "ex_abc", "values": [{"name": "quality", "score": 0.8}]}
  ]
}

Invalid example (annotation name not found in space)

{
  "annotations": [
    {"record_id": "ex_abc", "values": [{"name": "nonexistent_config"}]}
  ]
}