---
title: "Submit To Leaderboard"
method: POST
path: "/leaderboard/datasets/{dataset_id}/submit"
tags: ["leaderboard"]
---

# Submit To Leaderboard

`POST /leaderboard/datasets/{dataset_id}/submit`

Submit or update a leaderboard entry after evaluation.

If the user already has an entry for this dataset, it is updated only when
the new score is better (higher F1).

Args:
    dataset_id: Competition dataset.
    request: Evaluation to submit and the display name to show.
    auth: Authenticated caller.

Returns:
    The entry, its rank, and whether it is a new personal best.

Raises:
    HTTPException: 404 when the dataset or evaluation is not the caller's to
        use, 400 when the evaluation cannot be ranked, 500 when the
        submission cannot be written.

## Path parameters

- `dataset_id` string, required

## Request body

- LeaderboardSubmission — Request to submit an evaluation to the leaderboard.
  - `evaluation_id` string, required — ID of the completed evaluation
  - `display_name` string, required — Display name for leaderboard

## Response `200`

Successful Response

- LeaderboardSubmitResponse — Response after submitting to leaderboard.
  - `success` boolean
  - `entry` LeaderboardEntry, required — A single leaderboard entry.
    - `id` string, required
    - `dataset_id` string, required
    - `evaluation_id` string, required
    - `user_id` string, required
    - `display_name` string, required
    - `model_name` string, required
    - `model_id` string, nullable
    - `f1_score` number, required
    - `precision_score` number, nullable
    - `recall_score` number, nullable
    - `accuracy` number, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `rank` integer, nullable
  - `rank` integer, required
  - `is_new_best` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)