List source traces

POST

https://api.getzep.com/api/v4/trace-connections/:connection_uuid/traces/list

POST

/api/v4/trace-connections/:connection_uuid/traces/list

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.trace_connection.trace.list(
    connection_uuid="connection_uuid",
    provider_project_id="project_123",
)

{
  "items": [
    {
      "closed": true,
      "ended_at": "2026-01-01T00:01:00Z",
      "has_error": false,
      "imported_trajectories": [
        {
          "agent_uuid": "f8b28f94-4f5a-4b3a-b782-87aa8464ac04",
          "import_uuid": "332c28e1-e6a7-4bca-97b2-ef1ec82c65fa",
          "trajectory_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa"
        }
      ],
      "last_activity_at": "2026-01-01T00:01:00Z",
      "metadata": {},
      "name": "Handle support request",
      "scores": {
        "quality": 0.9
      },
      "source_revision": "123456789",
      "source_url": "https://app.braintrust.dev/app/trace_123",
      "span_count": 4,
      "started_at": "2026-01-01T00:00:00Z",
      "tags": [
        "support",
        "prod"
      ],
      "trace_id": "trace_123"
    }
  ],
  "next_cursor": "page-2"
}

Filter provider traces. Example body: {"provider_project_id":"project_123","filter":{"started_after":"2026-01-01T00:00:00Z"}}.

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

connection_uuidstringRequired

Trace connection UUID

Query parameters

limitintegerOptional

Page size from 1 to 100; default 25

cursorstringOptional

Opaque page cursor

Request

Provider project and trace filters

provider_project_idstringRequired

ProviderProjectID is the provider project identifier.

filterobjectOptional

Filter contains provider trace filters. Example: {"started_after":"2026-01-01T00:00:00Z"}.

Response

itemslist of objectsOptional

Items contains the source trace summaries on this page. Example: [{"trace_id":"trace_123","name":"Support trace"}].

next_cursorstringOptional

NextCursor is the cursor for the next provider page.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

502

Bad Gateway Error