List trace imports

GET

https://api.getzep.com/api/v4/agents/:agent_uuid/trace-imports

GET

/api/v4/agents/:agent_uuid/trace-imports

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trace_import.list(
    agent_uuid="agent_uuid",
)

{
  "items": [
    {
      "agent_uuid": "f8b28f94-4f5a-4b3a-b782-87aa8464ac04",
      "connection_uuid": "8c78a85e-eac2-4f57-b5f5-59a68a1e77a1",
      "created_at": "2026-01-01T00:00:00Z",
      "imported_trace_count": 10,
      "last_run": {
        "completed_at": "2026-01-01T00:01:00Z",
        "started_at": "2026-01-01T00:00:01Z",
        "status": "succeeded",
        "trigger": "create",
        "uuid": "ea7e2724-9bfd-4ca1-aa5c-40a1dd72a688"
      },
      "learn_from": true,
      "mapping": {
        "content": {
          "include_system_messages": false,
          "metadata_keys": [
            "ticket_id",
            "queue"
          ]
        },
        "include_outcomes": [
          "succeeded",
          "failed"
        ],
        "objective": {
          "key": "objective",
          "source": "metadata"
        },
        "outcome": [
          {
            "failed_below": 0.4,
            "key": "outcome",
            "name": "quality",
            "rule": "score",
            "succeeded_at_or_above": 0.8,
            "values": {
              "ok": "succeeded"
            }
          }
        ],
        "score_verifier": false,
        "task_family": {
          "fallback": "support/general",
          "key": "task_family",
          "prefix": "task:",
          "source": "fixed",
          "value": "support/refund"
        }
      },
      "name": "Support traces",
      "next_run_at": "2026-01-01T04:00:00Z",
      "on_source_change": "ignore",
      "pause_reason": "user",
      "provider": "braintrust",
      "provider_organization_id": "org_123",
      "provider_project_id": "project_123",
      "require_review": false,
      "revision": 1,
      "schedule": {
        "interval_hours": 4,
        "start_from": "now",
        "max_open_hours": 24,
        "settle_minutes": 60
      },
      "selection": {
        "filter": {
          "has_error": false,
          "metadata": {},
          "name": "Handle support request",
          "scores": [
            {
              "max": 1,
              "min": 0.5,
              "name": "quality"
            }
          ],
          "started_after": "2026-01-01T00:00:00Z",
          "started_before": "2026-02-01T00:00:00Z",
          "tags_all": [
            "support",
            "prod"
          ],
          "tags_any": [
            "support",
            "billing"
          ]
        },
        "trace_ids": [
          "trace_123",
          "trace_456"
        ]
      },
      "source_cursor_updated_at": "2026-01-01T00:00:00Z",
      "status": "active",
      "updated_at": "2026-01-01T00:00:00Z",
      "uuid": "332c28e1-e6a7-4bca-97b2-ef1ec82c65fa"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjI1fQ",
  "total_size": 1
}

List trace imports that belong to this Agent. Agent Skills is in closed release. Zep enables Agent Skills only for select accounts. A request from an account without access returns 403 permission_denied. To get access, contact support@getzep.com.

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

Query parameters

page_sizeintegerOptional1-200Defaults to 50

The maximum number of items in one page. The SDK method returns a pager. In Python, .items holds only the first page. In TypeScript, .data holds only the first page. To read every page, iterate the pager: use for or list(...) in Python, or for await in TypeScript. In Go, the method returns one page, and Iterator() reads all pages.

cursorstringOptional

Opaque page cursor

Response

itemslist of objectsOptional

Items contains trace imports on this page. Example: [{“uuid”:“332c28e1-e6a7-4bca-97b2-ef1ec82c65fa”,“name”:“Support traces”}].

next_cursorstringOptional

NextCursor is the cursor for the next page.

total_sizeintegerOptional

TotalSize is the number of matching imports.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error