---
title: "Create a Run"
method: POST
path: "/runs"
tags: ["runs"]
---

# Create a Run

`POST /runs`

Queues a single run for ingestion. The request body must be a JSON-encoded run object that follows the Run schema.

## Request body

- RunsRun
  - `dotted_order` string
  - `end_time` string
  - `error` string
  - `events` object[]
  - `extra` object
  - `id` string
  - `input_attachments` object
  - `inputs` object
  - `name` string
  - `output_attachments` object
  - `outputs` object
  - `parent_run_id` string
  - `reference_example_id` string
  - `run_type` 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser'
  - `serialized` object
  - `session_id` string
  - `session_name` string
  - `start_time` string
  - `status` string
  - `tags` string[]
  - `trace_id` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)