---
title: "Create Run"
method: POST
path: "/projects/{project_id}/runs"
tags: ["runs"]
---

# Create Run

`POST /projects/{project_id}/runs`

Create a new run in the given project.

Validates that no run with the same name exists, that the run's task type
is compatible with the project type, and that all existing runs share the
same task type before delegating to the async run-creation service.

## Path parameters

- `project_id` string, uuid4, required

## Request body

- RunCreate
  - `name` string, required
  - `project_id` string, uuid4, nullable
  - `created_by` string, uuid4, nullable
  - `num_samples` integer, nullable
  - `winner` boolean, nullable
  - `dataset_hash` string, nullable
  - `dataset_version_id` string, uuid4, nullable
  - `prompt_template_version_id` string, uuid4, nullable
  - `task_type` integer, required
  - `run_tags` RunTagCreateRequest[]
    - `key` string, required
    - `value` string, required
    - `tag_type` string, required

## Response `200`

Successful Response

- CreateRunResponse
  - `name` string, nullable
  - `project_id` string, uuid4, nullable
  - `created_by` string, uuid4, required
  - `num_samples` integer, required
  - `winner` boolean, required
  - `dataset_hash` string, nullable
  - `dataset_version_id` string, uuid4, nullable
  - `prompt_template_version_id` string, uuid4, nullable
  - `id` string, uuid4, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `task_type` 13 | 15 | 16 | 17 | 18 — Valid task types for modeling. We store these as ints instead of strings because we will be looking this up in the database frequently.
  - `last_updated_by` string, uuid4, required
  - `run_tags` RunTagDB[]
    - `key` string, required
    - `value` string, required
    - `tag_type` string, required
    - `project_id` string, uuid4, required
    - `run_id` string, uuid4, required
    - `created_by` string, uuid4, required
    - `id` string, uuid4, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)