List trajectory imports

GET

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

GET

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

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trajectory_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_trajectory_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,
        "max_open_hours": 24,
        "settle_minutes": 5,
        "start_from": "24h"
      },
      "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 trajectory imports that belong to this Agent.

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

Query parameters

limitintegerOptional

Page size

cursorstringOptional

Opaque page cursor

Response

itemslist of objectsOptional

Items contains trajectory 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