runs

Create a Run

Changed on

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

post/api/v1/runs

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v1/runs
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Request body

addressstring

Addresses the run to an Agent environment in place of session_id or session_name, as lrn:agents/{id}/environments/{environment}. The environment is case-insensitive. Self-hosted deployments need LangSmith v0.18 or later.

dotted_orderstring
end_timestring
errorstring
eventsobject[]
extraobject
idstring
input_attachmentsobject
inputsobject
namestring
output_attachmentsobject
outputsobject
parent_run_idstring
reference_example_idstring
run_type'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser'
serializedobject
session_idstring
session_namestring
start_timestring
statusstring
tagsstring[]
trace_idstring

Example request

{
  "address": "lrn:agents/support-agent/environments/production"
}

Changes

  • 1a8ee9358d81Revision changes
    • breaking

      added required request body

    • breaking

      the response's body type changed from no type to object for status

    • info

      api operation id create_run_proxy_api_v1_runs_post removed and replaced with

    • info

      api tag runs added

    • info

      api tag run removed

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • a0acb3a6a101Revision changes
    • info

      endpoint added