From 53543a00aa6dd96912e641ea029d5461d4d613e7 Mon Sep 17 00:00:00 2001
From: cthomas <caren@letta.com>
Date: Mon, 15 Sep 2025 15:32:15 -0700
Subject: [PATCH] feat: rename provider trace route (#2914)

---
 letta/server/rest_api/routers/v1/telemetry.py | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/letta/server/rest_api/routers/v1/telemetry.py b/letta/server/rest_api/routers/v1/telemetry.py
index 86421221..e317a791 100644
--- a/letta/server/rest_api/routers/v1/telemetry.py
+++ b/letta/server/rest_api/routers/v1/telemetry.py
@@ -10,12 +10,17 @@ from letta.settings import settings
 router = APIRouter(prefix="/telemetry", tags=["telemetry"])
 
 
-@router.get("/{step_id}", response_model=Optional[ProviderTrace], operation_id="retrieve_provider_trace")
-async def retrieve_provider_trace_by_step_id(
+@router.get("/{step_id}", response_model=Optional[ProviderTrace], operation_id="retrieve_provider_trace", deprecated=True)
+async def retrieve_provider_trace(
     step_id: str,
     server: SyncServer = Depends(get_letta_server),
     headers: HeaderParams = Depends(get_headers),
 ):
+    """
+    **DEPRECATED**: Use `GET /steps/{step_id}/trace` instead.
+
+    Retrieve provider trace by step ID.
+    """
     provider_trace = None
     if settings.track_provider_trace:
         try: