runs

Share a run

Changed on

Creates or returns a share token for a run. Child runs share their trace root.

Self-hosted deployments require LangSmith v0.16 or later.

post/api/v2/runs/{run_id}/share

Request

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

Path parameters

run_idstring uuid required

Run UUID

Request body

session_idstring uuid required

session_id is the tracing project UUID containing the trace.

trace_idstring uuid required

trace_id is the root trace UUID to share.

Example request

{
  "session_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327",
  "trace_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327"
}

Response

OK

share_tokenstring uuid

Example response

{
  "share_token": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327"
}

Changes