List traces in a public shared thread - Docs by LangChain

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "completion_cost": 123,
      "completion_cost_details": {
        "raw": {}
      },
      "completion_token_details": {
        "raw": {}
      },
      "completion_tokens": 123,
      "end_time": "2025-01-15T12:00:01.500Z",
      "error": "context deadline exceeded",
      "error_preview": "<string>",
      "first_token_time": "2024-01-15T10:30:00.312Z",
      "inputs": {},
      "inputs_preview": "<string>",
      "latency": 123,
      "name": "<string>",
      "op": 123,
      "outputs": {},
      "outputs_preview": "<string>",
      "prompt_cost": 123,
      "prompt_cost_details": {
        "raw": {}
      },
      "prompt_token_details": {
        "raw": {}
      },
      "prompt_tokens": 123,
      "start_time": "2025-01-15T12:00:00.000Z",
      "thread_id": "d4e5f6a7-b8c9-4d5e-1f2a-3b4c5d6e7f8a",
      "total_cost": 123,
      "total_tokens": 123,
      "trace_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327"
    }
  ],
  "next_cursor": "eyJydW5zX2N1cnNvciI6Imx0KGN1cnNvciwiLi4uIikifQ=="
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

GET

/

api

/

v2

/

public

/

threads

/

{share_token}

/

traces

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "completion_cost": 123,
      "completion_cost_details": {
        "raw": {}
      },
      "completion_token_details": {
        "raw": {}
      },
      "completion_tokens": 123,
      "end_time": "2025-01-15T12:00:01.500Z",
      "error": "context deadline exceeded",
      "error_preview": "<string>",
      "first_token_time": "2024-01-15T10:30:00.312Z",
      "inputs": {},
      "inputs_preview": "<string>",
      "latency": 123,
      "name": "<string>",
      "op": 123,
      "outputs": {},
      "outputs_preview": "<string>",
      "prompt_cost": 123,
      "prompt_cost_details": {
        "raw": {}
      },
      "prompt_token_details": {
        "raw": {}
      },
      "prompt_tokens": 123,
      "start_time": "2025-01-15T12:00:00.000Z",
      "thread_id": "d4e5f6a7-b8c9-4d5e-1f2a-3b4c5d6e7f8a",
      "total_cost": 123,
      "total_tokens": 123,
      "trace_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327"
    }
  ],
  "next_cursor": "eyJydW5zX2N1cnNvciI6Imx0KGN1cnNvciwiLi4uIikifQ=="
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "details": {
    "adapter": "<string>",
    "item_type": "<string>",
    "run_id": "<string>"
  },
  "error_class": "PARSE_FAILURE",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

Path Parameters

Share token UUID

Query Parameters

selects

string[]

required

repeatable public thread trace fields to include

cursor

string

opaque cursor from a previous page

page_size

integer

page size (default 20, max 100)

order

string

ASC or DESC

Response

OK

items

object[]

items is the page of root traces in this thread. Which properties are populated on each trace depends on the selects query parameter.

Show child attributes

next_cursor

string

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

Example:

"eyJydW5zX2N1cnNvciI6Imx0KGN1cnNvciwiLi4uIikifQ=="