How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

LangSmith public API

The public API from LangSmith — 20 operation(s) for public.

LangSmith public API is one of 73 APIs that LangSmith publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Public. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 20 operations across 20 paths, and defines 45 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against a single base URL, /.

20 operations 20 paths 45 schemas 13 GET7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.smith.langchain.com
Authentication
API Key, API Key, HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 4

LangSmith public API declares 4 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (API Key). An API key is passed in the header as X-Tenant-Id (Tenant ID). It accepts HTTP bearer tokens (Bearer Auth). An API key is passed in the header as X-Organization-Id (Organization ID).

  • Bearer Auth — Bearer tokens are used to authenticate from the UI. Must also specify x-tenant-id or x-organization-id (for org scoped apis).

Paths & Operations 20

Across 20 paths, the API surfaces 20 operations — 13 GET, 7 POST. Each is listed below with its method, path, parameters, and response codes.

public 20
GET
/api/v1/public/{share_token}/run
Get Shared Run
get_shared_run_api_v1_public__share_token__run_get 2 params → 200422
GET
/api/v1/public/{share_token}/run/{id}
Get Shared Run By Id
get_shared_run_by_id_api_v1_public__share_token__run__id__get 3 params → 200422
POST
/api/v1/public/{share_token}/runs/query
Query Shared Runs
query_shared_runs_api_v1_public__share_token__runs_query_post 1 param body → 200422
GET
/api/v1/public/{share_token}/feedbacks
Read Shared Feedbacks
read_shared_feedbacks_api_v1_public__share_token__feedbacks_get 11 params → 200422
GET
/api/v1/public/{share_token}/datasets
Read Shared Dataset
read_shared_dataset_api_v1_public__share_token__datasets_get 5 params → 200422
GET
/api/v1/public/{share_token}/examples/count
Count Shared Examples
count_shared_examples_api_v1_public__share_token__examples_count_get 5 params → 200422
GET
/api/v1/public/{share_token}/examples
Read Shared Examples
read_shared_examples_api_v1_public__share_token__examples_get 8 params → 200422
GET
/api/v1/public/{share_token}/datasets/sessions
Read Shared Dataset Tracer Sessions
read_shared_dataset_tracer_sessions_api_v1_public__share_token__datasets_sessions_get 12 params → 200422
GET
/api/v1/public/datasets/sessions-bulk
Read Shared Dataset Tracer Sessions Bulk
read_shared_dataset_tracer_sessions_bulk_api_v1_public_datasets_sessions_bulk_get 1 param → 200422
POST
/api/v1/public/{share_token}/examples/runs
Read Shared Dataset Examples With Runs
read_shared_dataset_examples_with_runs_api_v1_public__share_token__examples_runs_post 1 param body → 200422
POST
/api/v1/public/{share_token}/datasets/runs/delta
Read Shared Delta
read_shared_delta_api_v1_public__share_token__datasets_runs_delta_post 1 param body → 200422
POST
/api/v1/public/{share_token}/datasets/runs/delta/stream
Read Shared Delta Stream
read_shared_delta_stream_api_v1_public__share_token__datasets_runs_delta_stream_post 1 param body → 200422
POST
/api/v1/public/{share_token}/datasets/runs/query
Query Shared Dataset Runs
query_shared_dataset_runs_api_v1_public__share_token__datasets_runs_query_post 1 param body → 200422
POST
/api/v1/public/{share_token}/datasets/runs/generate-query
Generate Query For Shared Dataset Runs
generate_query_for_shared_dataset_runs_api_v1_public__share_token__datasets_runs_generate_query_post 1 param body → 200422
POST
/api/v1/public/{share_token}/datasets/runs/stats
Stats Shared Dataset Runs
stats_shared_dataset_runs_api_v1_public__share_token__datasets_runs_stats_post 1 param body → 200422
GET
/api/v1/public/{share_token}/datasets/runs/{run_id}
Read Shared Dataset Run
read_shared_dataset_run_api_v1_public__share_token__datasets_runs__run_id__get 3 params → 200422
GET
/api/v1/public/{share_token}/datasets/feedback
Read Shared Dataset Feedback
read_shared_dataset_feedback_api_v1_public__share_token__datasets_feedback_get 11 params → 200422
GET
/api/v1/public/{share_token}/datasets/comparative
Read Shared Comparative Experiments
read_shared_comparative_experiments_api_v1_public__share_token__datasets_comparative_get 7 params → 200422
GET
/api/v1/public/schemas/{version}/message.json
Get Message Json Schema
get_message_json_schema_api_v1_public_schemas__version__message_json_get 1 param → 200422
GET
/api/v1/public/schemas/{version}/tooldef.json
Get Tool Def Json Schema
get_tool_def_json_schema_api_v1_public_schemas__version__tooldef_json_get 1 param → 200422

Schemas 45

The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are RunPublicDatasetSchema (45 properties), RunPublicSchema (44 properties), RunSchemaComparisonView (37 properties), TracerSession (29 properties). Each schema is shown below with its type and property counts.

SourceType
string
Enum for feedback source types.
SessionFeedbackDelta
object
List of feedback keys with number of improvements and regressions for each.
1 property 1 required
RunTypeEnum
string
Enum for run types.
Example
object
Example schema.
10 properties 4 required
RunsGenerateQueryFeedbackKeys
string
ExampleSelect
string
DataType
string
Enum for dataset data types.
ValidationError
object
3 properties 3 required
SimpleExperimentInfo
object
Simple experiment info schema for use with comparative experiments
2 properties 2 required
RunSchemaComparisonView
object
Run schema for comparison view.
37 properties 6 required
SessionSortableColumns
string
FeedbackDelta
object
Feedback key with number of improvements and regressions.
2 properties 2 required
FeedbackSource
object
The feedback source loaded from the database.
5 properties
RequestBodyForRunsGenerateQuery
object
2 properties 1 required
RunsFilterDataSourceTypeEnum
string
Enum for run data source types.
QueryFeedbackDelta
object
7 properties 3 required
SortByDatasetColumn
string
Enum for available dataset columns to sort by.
RunPublicDatasetSchema
object
Schema for a run in a publicly-shared dataset.
45 properties 7 required
RunSelect
string
Enum for available run columns.
ResponseBodyForRunsGenerateQuery
object
2 properties 2 required
QueryFeedbackDeltaBatch
object
Request schema for batched feedback delta queries with multiple feedback keys.
4 properties 3 required
PublicComparativeExperiment
object
Publicly-shared ComparativeExperiment schema.
8 properties 4 required
RunDateOrder
string
Enum for run start date order.
TracerSession
object
TracerSession schema.
29 properties 2 required
BodyParamsForRunSchema
object
Query params for run endpoints.
24 properties
RunStatsGroupBy
object
Group by param for run stats.
3 properties 1 required
FeedbackLevel
string
Enum for feedback levels.
ListPublicDatasetRunsResponse
object
3 properties 2 required
RunPublicSchema
object
44 properties 6 required
RunStatsQueryParams
object
Query params for run stats.
22 properties
ExampleWithRunsCH
object
Example schema with list of runs from ClickHouse. For non-grouped endpoint (/datasets/{datasetid}/runs): runs from single session. For grouped endpoint (/datas…
11 properties 5 required
HTTPValidationError
object
1 property
TraceTier
string
PublicExampleWithRuns
object
Schema for an example in a publicly-shared dataset with list of runs.
11 properties 5 required
SortByComparativeExperimentColumn
string
Enum for available comparative experiment columns to sort by.
RunStats
object
28 properties
QueryExampleSchemaWithRuns
object
9 properties 1 required
DatasetPublicSchema
object
Public schema for datasets. Doesn't currently include session counts/stats since public test project sharing is not yet shipped
10 properties 3 required
DatasetTransformation
object
2 properties 2 required
QueryParamsForPublicRunSchema
object
Query params for public run endpoints.
1 property
SortParamsForRunsComparisonView
object
2 properties 1 required
DatasetTransformationType
string
Enum for dataset transformation types. Ordering determines the order in which transformations are applied if there are multiple transformations on the same pat…
RunStatsSelect
string
Metrics you can select from run stats endpoint.
ListPublicRunsResponse
object
3 properties 2 required
FeedbackSchema
object
Schema for getting feedback.
18 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

langsmith-public-api-openapi.yml Raw ↑

Other APIs LangSmith publishes across the network.

LangSmith access_policies API
LangSmith ace API
LangSmith agents API
LangSmith alert_rules API
LangSmith annotation-queues API
LangSmith api-key API
LangSmith audit-logs API
LangSmith auth API
LangSmith aws_marketplace API
LangSmith backfills API
LangSmith beacon API
LangSmith bulk-exports API
Where this information came from

This is an independent, third-party profile of LangSmith public API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.