Request Request body
objective string Required
The task-instance objective captured for this attempt.
learn_from boolean Optional
Whether eligible evidence may participate in learning. Defaults to true.
metadata map from strings to any Optional
Developer metadata used to organize and filter Traces.
parent_trace_uuid string Optional
The parent Trace UUID when this attempt retries an earlier attempt.
task_family string Optional
The task-family slug. Optional when inferred task families are enabled
for the account: the service assigns one after the Trace closes.
trace_id string Optional
The optional customer-assigned identifier, unique within the Agent.
OK
abandoned_at string Optional
The time the Trace was abandoned.
agent_uuid string Optional
The owning Agent UUID.
attempt_family_uuid string Optional
The stable retry-family identity shared with declared child attempts.
closed_at string Optional
The time the Trace closed.
created_at string Optional
The time the Trace was created.
internal object Optional
Server-owned fields that are not part of the top-level capture contract.
learn_from boolean Optional
Whether eligible evidence may participate in learning.
learn_from_reason string Optional
Why the Trace is not eligible for learning.
metadata map from strings to any Optional
Developer metadata used for exact containment filters.
objective string Optional
The task-instance objective captured for this attempt.
outcome enum Optional
The caller-owned task outcome.
Allowed values: succeeded failed partial abandoned unknown
parent_trace_uuid string Optional
The parent attempt when this Trace is a retry.
revision integer Optional
The revision required by the next update or lifecycle command.
source object Optional
The source record for an imported Trace.
status enum Optional
The current lifecycle state.
Allowed values: open closing closed abandoned deleted
task_family string Optional
The optional opaque task-family classification slug.
task_family_inference object Optional
The latest task-family inference outcome. Absent when inference never
ran for this Trace.
task_family_source string Optional
Who supplied task_family: the caller (declared), an import rule
(import_rule), or the service classifier (inferred).
trace_id string Optional
The optional customer-assigned identifier, unique within the Agent.
updated_at string Optional
The time the Trace was last updated.
uuid string Optional
The stable Trace UUID.
verification enum Optional
The strength of the accepted outcome verification.
Allowed values: none agent tool customer external
