> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-docssu-1780674012-e7ef61e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Run

> Delete a run by ID.

For threads using [`DeltaChannel`](/oss/python/langgraph/pregel#deltachannel), deleting a run skips checkpoint deletion and removes only the run record. The run's checkpoints may store delta writes that later checkpoints depend on for state reconstruction, so they are preserved. To reclaim checkpoint storage on delta-channel threads, use [Prune Threads](/langsmith/agent-server-api/threads/prune-threads) instead.



## OpenAPI

````yaml /langsmith/agent-server-openapi.json delete /threads/{thread_id}/runs/{run_id}
openapi: 3.1.0
info:
  title: LangSmith Deployment
  version: 0.1.0
servers: []
security: []
tags:
  - name: Assistants
    description: An assistant is a configured instance of a graph.
  - name: Threads
    description: A thread contains the accumulated outputs of a group of runs.
  - name: Thread Runs
    description: >-
      A run is an invocation of a graph / assistant on a thread. It updates the
      state of the thread.
  - name: Stateless Runs
    description: >-
      A run is an invocation of a graph / assistant, with no state or memory
      persistence.
  - name: Crons
    description: >-
      A cron is a periodic run that recurs on a given schedule. The repeats can
      be isolated, or share state in a thread
  - name: Store
    description: >-
      Store is an API for managing persistent key-value store (long-term memory)
      that is available from any thread.
  - name: A2A
    description: >-
      Agent-to-Agent Protocol related endpoints for exposing assistants as
      A2A-compliant agents.
  - name: MCP
    description: >-
      Model Context Protocol related endpoints for exposing an agent as an MCP
      server.
  - name: System
    description: System endpoints for health checks, metrics, and server information.
  - name: Streaming
    description: >-
      Thread-centric streaming endpoints. Provides a structured command/event
      surface over SSE+HTTP; WebSocket is also supported at
      `/threads/{thread_id}/stream/events` (not documented here — OpenAPI 3.1
      does not describe WebSocket).
paths:
  /threads/{thread_id}/runs/{run_id}:
    delete:
      tags:
        - Thread Runs
      summary: Delete Run
      description: >-
        Delete a run by ID.


        For threads using
        [`DeltaChannel`](/oss/python/langgraph/pregel#deltachannel), deleting a
        run skips checkpoint deletion and removes only the run record. The run's
        checkpoints may store delta writes that later checkpoints depend on for
        state reconstruction, so they are preserved. To reclaim checkpoint
        storage on delta-channel threads, use [Prune
        Threads](/langsmith/agent-server-api/threads/prune-threads) instead.
      operationId: delete_run_threads__thread_id__runs__run_id__delete
      parameters:
        - description: The ID of the thread.
          required: true
          schema:
            type: string
            format: uuid
            title: Thread Id
            description: The ID of the thread.
          name: thread_id
          in: path
        - description: The ID of the run.
          required: true
          schema:
            type: string
            format: uuid
            title: Run Id
            description: >-
              For threads using
              [`DeltaChannel`](/oss/python/langgraph/pregel#deltachannel),
              deleting a run skips checkpoint deletion and removes only the run
              record. The run's checkpoints may store delta writes that later
              checkpoints depend on for state reconstruction, so they are
              preserved. To reclaim checkpoint storage on delta-channel threads,
              use [Prune
              Threads](/langsmith/agent-server-api/threads/prune-threads)
              instead.
          name: run_id
          in: path
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema: {}
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
          description: Human-readable error message
      title: ErrorResponse
      description: Error response returned from the server

````