Sessions

Create a new project.

GET with body payload — no resources created. Returns the prebuilt dashboard for the tracing project matching the query passed as the request payload.

Delete a specific project.

Returns 202 when deletion is accepted. Cleanup runs asynchronously. Location identifies the affected project, not a cleanup-status endpoint. For a caller with read access, GET at that URL returns 200 with the project while it is still available, or 404 after the project is removed. A 404 does not confirm that background trace cleanup has finished. Polling for cleanup completion is not supported.

Returns a page of the workspace's tracing projects and experiments. Pass the response's next_cursor as cursor to fetch the next page; next_cursor is null on the last page. A cursor is valid only with the same query parameters as the request that returned it.

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 a specific project.

Update a project.