---
title: "Ingest Runs (Batch JSON)"
method: POST
path: "/runs/batch"
tags: ["runs"]
---

# Ingest Runs (Batch JSON)

`POST /runs/batch`

Ingests a batch of runs in a single JSON payload. The payload must have `post` and/or `patch` arrays containing run objects.
Prefer this endpoint over single‑run ingestion when submitting hundreds of runs, but `/runs/multipart` offers better handling for very large fields and attachments.

## Request body

- object
  - `patch` 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
  - `post` 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/revisions/a0acb3a6a101/schema)