List trajectory import runs

GET

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

GET

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

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

{
  "items": [
    {
      "completed_at": "2026-01-01T00:01:00Z",
      "counts": {
        "imported": 10
      },
      "created_at": "2026-01-01T00:00:00Z",
      "due_at": "2026-01-01T04:00:00Z",
      "error_code": "credential_rejected",
      "import_uuid": "332c28e1-e6a7-4bca-97b2-ef1ec82c65fa",
      "more_available": false,
      "skip_reasons": {
        "trace_not_closed": 1
      },
      "started_at": "2026-01-01T00:00:01Z",
      "status": "pending",
      "task_uuid": "3124c01a-8f49-4bfd-9758-6ce491a377c1",
      "trigger": "create",
      "uuid": "ea7e2724-9bfd-4ca1-aa5c-40a1dd72a688"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjI1fQ",
  "total_size": 1
}

List runs that belong to this trajectory import.

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

import_uuidstringRequired

Trajectory import UUID

Query parameters

limitintegerOptional

Page size

cursorstringOptional

Opaque page cursor

Response

itemslist of objectsOptional

Items contains runs on this page. Example: [{"uuid":"ea7e2724-9bfd-4ca1-aa5c-40a1dd72a688","status":"pending"}].

next_cursorstringOptional

NextCursor is the cursor for the next page.

total_sizeintegerOptional

TotalSize is the number of matching runs.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error