---
title: "Universal Score CRUD."
method: GET
path: "/model-hub/scores/"
tags: ["model-hub"]
---

# Universal Score CRUD.

`GET /model-hub/scores/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/model-hub/scores/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

GET    /model-hub/scores/?source_type=trace&source_id=<uuid>
POST   /model-hub/scores/                 (single score)
POST   /model-hub/scores/bulk/            (multiple scores on one source)
DELETE /model-hub/scores/<id>/

## Query parameters

- `page` integer
- `limit` integer
- `source_type` 'dataset_row' | 'trace' | 'observation_span' | 'prototype_run' | 'call_execution' | 'trace_session'
- `source_id` string
- `label_id` string, uuid
- `annotator_id` string, uuid

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Score[], required
    - `id` string, uuid
    - `source_type` 'dataset_row' | 'trace' | 'observation_span' | 'prototype_run' | 'call_execution' | 'trace_session', required
    - `source_id` string
    - `label_id` string, uuid
    - `label_name` string
    - `label_type` string
    - `label_settings` object
    - `label_allow_notes` boolean
    - `value` object, required
    - `value_history` object
    - `score_source` 'human' | 'api' | 'auto' | 'imported'
    - `notes` string, nullable
    - `annotator` string, uuid, nullable
    - `annotator_name` string
    - `annotator_email` string
    - `queue_item` string, uuid, nullable
    - `queue_id` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

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