Retrieve Trace For Step

get/v1/steps/{step_id}/trace

Path ParametersExpand Collapse

step_id: string

The ID of the step in the format 'step-'

minLength41

maxLength41

ReturnsExpand Collapse

ProviderTrace = object { request_json, response_json, id, 9 more }

Letta's internal representation of a provider trace.

Attributes: id (str): The unique identifier of the provider trace. request_json (Dict[str, Any]): JSON content of the provider request. response_json (Dict[str, Any]): JSON content of the provider response. step_id (str): ID of the step that this trace is associated with. agent_id (str): ID of the agent that generated this trace. agent_tags (list[str]): Tags associated with the agent for filtering. call_type (str): Type of call (agent_step, summarization, etc.). run_id (str): ID of the run this trace is associated with. organization_id (str): The unique identifier of the organization. created_at (datetime): The timestamp when the object was created.

request_json: map[unknown]

JSON content of the provider request

response_json: map[unknown]

JSON content of the provider response

id: optional string

The human-friendly ID of the Provider_trace

agent_id: optional string

ID of the agent that generated this trace

agent_tags: optional array of string

Tags associated with the agent for filtering

call_type: optional string

Type of call (agent_step, summarization, etc.)

created_at: optional string

The timestamp when the object was created.

formatdate-time

created_by_id: optional string

The id of the user that made this object.

last_updated_by_id: optional string

The id of the user that made this object.

run_id: optional string

ID of the run this trace is associated with

step_id: optional string

ID of the step that this trace is associated with

updated_at: optional string

The timestamp when the object was last updated.

formatdate-time

Retrieve Trace For Step

curl https://api.letta.com/v1/steps/$STEP_ID/trace \
    -H "Authorization: Bearer $LETTA_API_KEY"

{
  "request_json": {
    "foo": "bar"
  },
  "response_json": {
    "foo": "bar"
  },
  "id": "provider_trace-123e4567-e89b-12d3-a456-426614174000",
  "agent_id": "agent_id",
  "agent_tags": [
    "string"
  ],
  "call_type": "call_type",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "last_updated_by_id": "last_updated_by_id",
  "run_id": "run_id",
  "step_id": "step_id",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

{
  "request_json": {
    "foo": "bar"
  },
  "response_json": {
    "foo": "bar"
  },
  "id": "provider_trace-123e4567-e89b-12d3-a456-426614174000",
  "agent_id": "agent_id",
  "agent_tags": [
    "string"
  ],
  "call_type": "call_type",
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "last_updated_by_id": "last_updated_by_id",
  "run_id": "run_id",
  "step_id": "step_id",
  "updated_at": "2019-12-27T18:11:19.117Z"
}