List trace connections

GET

https://api.getzep.com/api/v4/trace-connections

GET

/api/v4/trace-connections

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.trace_connection.list()

{
  "items": [
    {
      "created_at": "2026-01-01T00:00:00Z",
      "credential_hint": "1234",
      "credential_version": 1,
      "import_count": 2,
      "last_verified_at": "2026-01-01T00:00:00Z",
      "name": "Support traces",
      "provider": "braintrust",
      "provider_organization_id": "org_123",
      "provider_organization_name": "Example organization",
      "settings": {
        "api_url": "https://api.braintrust.dev",
        "requests_per_minute": 10,
        "retention_days": 30
      },
      "status": "active",
      "updated_at": "2026-01-01T00:00:00Z",
      "uuid": "8c78a85e-eac2-4f57-b5f5-59a68a1e77a1"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjI1fQ",
  "total_size": 1
}

List trace connections in the current Zep project.

Authentication

AuthorizationApi-Key

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

Query parameters

limitintegerOptional

Page size

cursorstringOptional

Opaque page cursor

Response

itemslist of objectsOptional

Items contains the trace connections on this page. Example: [{"uuid":"8c78a85e-eac2-4f57-b5f5-59a68a1e77a1"}].

next_cursorstringOptional

NextCursor is the cursor for the next page.

total_sizeintegerOptional

TotalSize is the number of matching connections.

Errors

401

Unauthorized Error

403

Forbidden Error