Append Agent Trajectory Event

POST

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

POST

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

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trajectory.append_event(
    agent_uuid="agent_uuid",
    trajectory_uuid="trajectory_uuid",
    event_type="input_reference",
)

{
  "agent_uuid": "string",
  "content": "string",
  "context": {
    "artifacts": [
      {
        "name": "string",
        "version": "string"
      }
    ],
    "environments": [
      {
        "name": "string",
        "version": "string"
      }
    ],
    "model": {
      "name": "string",
      "version": "string"
    },
    "tools": [
      {
        "name": "string",
        "version": "string"
      }
    ],
    "verification": "string"
  },
  "created_at": "string",
  "event_id": "string",
  "event_type": "input_reference",
  "failed_at": "string",
  "metadata": {},
  "occurred_at": "string",
  "processed_at": "string",
  "processing_state": "pending",
  "sequence": 1,
  "sources": [
    {
      "kind": "string",
      "uuid": "string",
      "copy_mode": "reference",
      "retention_mode": "delete_with_source"
    }
  ],
  "trajectory_uuid": "string",
  "updated_at": "string",
  "uuid": "string"
}

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

event_typeenumRequired

contentstringOptional

contextobjectOptional

event_idstringOptional

metadatamap from strings to anyOptional

occurred_atstringOptional

sequenceintegerOptional

sourceslist of objectsOptional

Response

agent_uuidstringOptional

contentstringOptional

contextobjectOptional

created_atstringOptional

event_idstringOptional

event_typeenumOptional

failed_atstringOptional

metadatamap from strings to anyOptional

occurred_atstringOptional

processed_atstringOptional

processing_stateenumOptional

Allowed values:

sequenceintegerOptional

sourceslist of objectsOptional

trajectory_uuidstringOptional

updated_atstringOptional

uuidstringOptional

Errors

400

Bad Request Error

403

Forbidden Error

409

Conflict Error

503

Service Unavailable Error