---
title: "Resolve an address to its tracing project"
method: GET
path: "/api/v1/sessions/resolutions"
tags: ["sessions"]
---

# Resolve an address to its tracing project

`GET /api/v1/sessions/resolutions`

## Request

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

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.

## Query parameters

- `kind` 'AGENT' | 'EXPERIMENT' | 'EVALUATOR', required
- `id` string
- `environment` 'LOCAL' | 'DEVELOPMENT' | 'STAGING' | 'PRODUCTION'

## Response `200`

OK

- AddressesResolveResponse
  - `session_id` string, uuid, required: `session_id` is the tracing project (session) the address names.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error
- `501`: Not Implemented

## Changes

- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/sessions/resolutions/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)