Get Current Agent Trace Summary

{
  "agent_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "assertion_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "created_at": "2026-01-01T00:00:00Z",
  "creation_reason": "close",
  "first_occurred_at": "2026-01-01T00:00:00Z",
  "first_sequence": 1,
  "last_occurred_at": "2026-01-01T00:00:00Z",
  "last_sequence": 1,
  "omitted_sequence_ranges": [
    {
      "first_sequence": 1,
      "last_sequence": 1,
      "reason": "narrower_authorization_boundary"
    }
  ],
  "outcome": "succeeded",
  "parent_version_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "structured_summary": {
    "ambiguities": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "approach": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "artifacts": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "name": "payment_gateway",
        "version": "2026.09.01"
      }
    ],
    "candidate_lessons": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "corrections": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "coverage": {
      "excerpted_events": [
        {
          "content_bytes": 1,
          "event_id": "event-001",
          "omitted_byte_ranges": [
            {
              "end": 1,
              "start": 1
            }
          ],
          "sequence": 1
        }
      ],
      "first_sequence": 1,
      "last_sequence": 1,
      "omitted_sequence_ranges": [
        {
          "first_sequence": 1,
          "last_sequence": 1,
          "reason": "narrower_authorization_boundary"
        }
      ]
    },
    "effective_steps": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "environments": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "name": "payment_gateway",
        "version": "2026.09.01"
      }
    ],
    "errors": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "event_time_basis": "source",
    "first_event_time": "2026-09-01T12:00:00Z",
    "ineffective_steps": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "last_event_time": "2026-09-01T12:05:00Z",
    "objective": "Refund a duplicate charge.",
    "recoveries": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "text": "The duplicate charge was refunded."
      }
    ],
    "reported_outcome": "succeeded",
    "result": {
      "citations": [
        {
          "event_id": "event-001",
          "sequence": 1
        }
      ],
      "text": "The duplicate charge was refunded."
    },
    "task_family": "support/refund",
    "tools": [
      {
        "citations": [
          {
            "event_id": "event-001",
            "sequence": 1
          }
        ],
        "name": "payment_gateway",
        "version": "2026.09.01"
      }
    ],
    "verification": {
      "citations": [
        {
          "event_id": "event-001",
          "sequence": 1
        }
      ],
      "details": [
        {
          "citations": [
            {
              "event_id": "event-001",
              "sequence": 1
            }
          ],
          "text": "The duplicate charge was refunded."
        }
      ],
      "status": "unverified",
      "verifier_ids": [
        "billing-audit"
      ]
    }
  },
  "text": "The duplicate charge was refunded.",
  "trace_uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "uuid": "6a906e70-50ca-4e43-a874-5fcae02a71fa",
  "verification": "none",
  "version": 1
}

Authentication

AuthorizationApi-Key

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

Path parameters

agent_uuidstringRequired

Agent UUID

trace_uuidstringRequired

Trace UUID

Response

agent_uuidstringOptional

The service returns the UUID of the owning Agent.

assertion_uuidstringOptional

The service returns the verification assertion linked to this evidence.

created_atstringOptional

The service returns when Zep created this resource.

creation_reasonenumOptional

The service returns what caused this summary version. Valid values are close, abandon, revision, task_family_correction, evidence_deletion, policy_change.

first_occurred_atstringOptional

The service returns when the first event occurred.

first_sequenceintegerOptional

The service returns the first event sequence included in this summary.

last_occurred_atstringOptional

The service returns when the last event occurred.

last_sequenceintegerOptional

The service returns the last event sequence included in this summary.

omitted_sequence_rangeslist of objectsOptional

The service returns event sequence ranges that this summary omits.

outcomeenumOptional

The service returns the task outcome. Valid values are succeeded, failed, partial, abandoned, unknown.

Allowed values:

parent_version_uuidstringOptional

The service returns the UUID of the parent summary version, when one exists.

structured_summaryobjectOptional

The service returns the structured summary generated for this Trace.

textstringOptional

The service returns text that a person can read.

trace_uuidstringOptional

The service returns the UUID of the source Trace.

uuidstringOptional

The service returns the UUID that identifies this summary version.

verificationenumOptional

The service returns how the outcome was verified. Valid values are none, agent, tool, customer, external, unverified, agent_verified, tool_verified, customer_verified, externally_verified.

Allowed values:

versionintegerOptional

The service returns this summary version number.

Errors

503

Service Unavailable Error