Pause a trajectory import

POST

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

POST

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

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

{
  "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"
}

Pause a scheduled trajectory import. One-time imports cannot be paused.

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

Response

agent_uuidstringOptional

AgentUUID is the owning Agent identifier.

connection_uuidstringOptional

ConnectionUUID is the trace connection identifier.

created_atstringOptional

CreatedAt is the resource creation time.

imported_trajectory_countintegerOptional

ImportedTrajectoryCount is the number of Trajectories currently owned by this import.

last_runobjectOptional

LastRun is the latest run for this import, when one exists.

learn_frombooleanOptional

LearnFrom reports whether imported evidence can support Skills.

mappingobjectOptional

Mapping defines how traces become Trajectories. Example: {"task_family":{"source":"fixed","value":"support"}}.

namestringOptional

Name is the import display name.

next_run_atstringOptional

NextRunAt is the next scheduled run time.

on_source_changestringOptional

OnSourceChange defines how changed source traces are handled.

pause_reasonenumOptional

PauseReason is the reason for a paused import, when present.

Allowed values:

providerstringOptional

Provider is the observability provider.

provider_organization_idstringOptional

ProviderOrganizationID is the provider organization identifier.

provider_project_idstringOptional

ProviderProjectID is the source project identifier.

require_reviewbooleanOptional

RequireReview reports whether candidate review is required.

revisionintegerOptional

Revision is the import update revision.

scheduleobjectOptional

Schedule contains recurring import settings, when enabled. Example: {"interval_hours":4,"start_from":"24h","settle_minutes":5,"max_open_hours":24}.

selectionobjectOptional

Selection defines the source traces to import. Example: {"trace_ids":["trace_123"]}.

source_cursor_updated_atstringOptional

SourceCursorUpdatedAt is the last source cursor update time.

statusstringOptional

Status is the import status.

updated_atstringOptional

UpdatedAt is the last resource update time.

uuidstringOptional

UUID is the trajectory import identifier.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error