sessions

Resolve an address to its tracing project

Changed on

Returns the tracing project (session) an address names. An address is an AGENT (id and environment), an EXPERIMENT (id), or an EVALUATOR (no id: evaluator traces share one project per workspace). Send kind and environment in upper case, as listed; they are matched case-insensitively, while the Agent id is case-sensitive. An address that does not exist, or whose project you cannot read, is a 404. Pass the returned session_id to any endpoint that takes a project (session) ID. This is not supported on a BYOC data plane yet, and is a 501 there. Self-hosted deployments need LangSmith v0.18 or later.

get/api/v1/sessions/resolutions

Request

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

Query parameters

kind'AGENT' | 'EXPERIMENT' | 'EVALUATOR' required

The kind of address.

idstring

The Agent's user-assigned id for AGENT, or the experiment's id for EXPERIMENT. Not set for EVALUATOR.

environment'LOCAL' | 'DEVELOPMENT' | 'STAGING' | 'PRODUCTION'

The Agent environment. Only set for AGENT.

Response

OK

session_idstring uuid required

session_id is the tracing project (session) the address names.

Changes