Create Score

Create a single annotation score on a source.

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

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.

label_id string Required

UUID of the annotation label to use for this score.

value object Required

The score value as JSON. The structure depends on the label type (e.g., rating: 5 for star, selected: [“option1”] for categorical).

notes string Optional

Optional freeform notes to attach to the score.

score_source string Optional Defaults to human

Origin of the score. Defaults to "human". Other values include "automation" or "sdk".

Response

201 Created
id string
UUID of the created score.
source_type string
The source type.
source_id string
UUID of the source.
label_id string
UUID of the label used.
label_name string
Display name of the label.
label_type string
Type of the label (text, categorical, numeric, star, thumbs_up_down).
value object
The score value.
score_source string
Origin of the score.
notes string
Attached notes, if any.
annotator string
UUID of the user who created the score.
annotator_name string
Display name of the annotator.
annotator_email string
Email of the annotator.
queue_item string
UUID of the associated queue item, if any.
created_at string
ISO 8601 timestamp of creation.
updated_at string
ISO 8601 timestamp of last update.

Note

Creating a score also writes a legacy TraceAnnotation for backward compatibility. If the annotated source belongs to an annotation queue and all required labels are now scored, the queue item may auto-complete.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE