Bulk Create Scores

Create multiple scores on a single source in one request.

POST https://api.futureagi.com/model-hub/scores/bulk/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Request body

source_type string Required

The type of source to annotate. One of trace, span, generation, or session.

source_id string Required

UUID of the source object to annotate.

scores array Required

Array of score objects to create. Each object contains:

  • label_id (string, required) — UUID of the annotation label.
  • value (object, required) — The score value as JSON.
  • score_source (string, optional) — Origin of the score. Defaults to "human".
notes string Optional

Optional freeform notes applied to all scores in the batch.

Response

201 Created
scores array
Array of successfully created Score objects. Each object has the same shape as the single create endpoint response (id, source_type, source_id, label_id, label_name, label_type, value, score_source, notes, annotator, annotator_name, annotator_email, queue_item, created_at, updated_at).
errors array
Array of error strings for any scores that failed to create.
GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE