LAlangchain-ai
threads

List traces in a public shared thread

Changed on

Returns a page of root traces belonging to the thread identified by the share token. The share token supplies the tenant, project, and thread scope.

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

get/api/v2/public/threads/{share_token}/traces

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v2/public/threads/{share_token}/traces
  • Auth
    none declared

Path parameters

share_tokenstring uuid required

Share token UUID

Query parameters

selectsstring[] required

repeatable public thread trace fields to include

cursorstring

opaque cursor from a previous page

page_sizeinteger

page size (default 20, max 100)

orderstring

ASC or DESC

Response

OK

next_cursorstring

next_cursor is the opaque cursor to pass as cursor on the next request. Null on the final page.

Example response

{
  "items": [
    {
      "end_time": "2025-01-15T12:00:01.500Z",
      "error": "context deadline exceeded",
      "first_token_time": "2024-01-15T10:30:00.312Z",
      "start_time": "2025-01-15T12:00:00.000Z",
      "thread_id": "d4e5f6a7-b8c9-4d5e-1f2a-3b4c5d6e7f8a",
      "trace_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327",
      "turn_number": 1
    }
  ],
  "next_cursor": "eyJydW5zX2N1cnNvciI6Imx0KGN1cnNvciwiLi4uIikifQ=="
}

Changes