Update Agent Trajectory

PATCH

https://api.getzep.com/api/v4/agents/:agent_uuid/trajectories/:trajectory_uuid

PATCH

/api/v4/agents/:agent_uuid/trajectories/:trajectory_uuid

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trajectory.update(
    agent_uuid="agent_uuid",
    trajectory_uuid="trajectory_uuid",
    expected_revision=1,
    task_family="string",
)

{
  "abandoned_at": "string",
  "agent_uuid": "string",
  "attempt_family_uuid": "string",
  "closed_at": "string",
  "created_at": "string",
  "internal": {
    "assertion_uuid": "string",
    "closing_sequence": 1,
    "current_summary_version": 1,
    "last_task_uuid": "string",
    "next_sequence": 1,
    "processing_state": "idle"
  },
  "learn_from": true,
  "learn_from_reason": "string",
  "metadata": {},
  "objective": "string",
  "outcome": "succeeded",
  "parent_trajectory_uuid": "string",
  "revision": 1,
  "source": {
    "connection_uuid": "string",
    "import_uuid": "string",
    "imported_at": "string",
    "kind": "trace_import",
    "provider": "string",
    "provider_project_id": "string",
    "run_uuid": "string",
    "scores": {},
    "source_changed": false,
    "source_revision": "string",
    "source_url": "string",
    "trace_ended_at": "string",
    "trace_id": "string",
    "trace_started_at": "string"
  },
  "status": "open",
  "task_family": "string",
  "trajectory_id": "string",
  "updated_at": "string",
  "uuid": "string",
  "verification": "none"
}

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

trajectory_uuidstringRequired

Trajectory UUID

Request

Request body

expected_revisionintegerRequired>=1

The current Trajectory revision used for optimistic concurrency.

task_familystring or nullRequired

Replacement task-family slug. Set to null to clear it.

Response

abandoned_atstringOptional

The time the Trajectory was abandoned.

agent_uuidstringOptional

The owning Agent UUID.

attempt_family_uuidstringOptional

The stable retry-family identity shared with declared child attempts.

closed_atstringOptional

The time the Trajectory closed.

created_atstringOptional

The time the Trajectory was created.

internalobjectOptional

Server-owned fields that are not part of the top-level capture contract.

learn_frombooleanOptional

Whether eligible evidence may participate in learning.

learn_from_reasonstringOptional

Why the Trajectory is not eligible for learning.

metadatamap from strings to anyOptional

Developer metadata used for exact containment filters.

objectivestringOptional

The task-instance objective captured for this attempt.

outcomeenumOptional

The caller-owned task outcome.

Allowed values:

parent_trajectory_uuidstringOptional

The parent attempt when this Trajectory is a retry.

revisionintegerOptional

The revision required by the next update or lifecycle command.

sourceobjectOptional

The source record for an imported Trajectory.

statusenumOptional

The current lifecycle state.

Allowed values:

task_familystringOptional

The optional opaque task-family classification slug.

trajectory_idstringOptional

The optional customer-assigned identifier, unique within the Agent.

updated_atstringOptional

The time the Trajectory was last updated.

uuidstringOptional

The stable Trajectory UUID.

verificationenumOptional

The strength of the accepted outcome verification.

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error