Skip to main content
POST
Capture event
Generate event_id client-side (UUID) so child events can reference their parent before the parent’s response returns.

Body

Core rules

  • One session per conversation: reuse session_id on every event.
  • One event per turn-pair: primitive_name is the agent name, args is the user input, result is the assistant output. Don’t emit separate output events.
  • Merge assistant turns: if one user turn is followed by N assistant turns (with tool calls between), concatenate the N texts into a single result.
  • Tool calls = own event: primitive_name is the tool name, args/result are plain text or JSON-encoded strings.
  • Sub-tools chain: when a tool invokes another tool, set parent_id to the parent tool’s event_id.
  • Sensitive data: Agnost does not currently provide automatic PII redaction before ingestion. See Data Governance for redaction and pseudonymization patterns.

Verify

Send one event, then open Raw logs in Agnost. Confirm primitive_name, args, result, success, and latency look right.

Troubleshooting

  • event_id and session_id must be UUIDs.
  • Create the session first with Capture Session.
  • For tool calls, set parent_id when the tool was triggered by another agent/tool event.

Headers

x-org-id
string
required

Your organization ID (UUID, case-insensitive).

Example:

"<org-id>"

Body

application/json
event_id
string<uuid>
required

Client-generated UUID. Use as parent_id on child events.

Example:

"e8b1c52f-3a9d-4e7c-8f0b-2d6a91c4ef58"

session_id
string<uuid>
required

Session UUID from capture-session.

Example:

"a3f9c182-7d4e-4b6a-9e21-c5d8f0b4e731"

primitive_name
string
required

Agent name (turn-pair) or tool name (tool call).

Example:

"your-agent-name"

args
string
required

Input — user message or JSON-encoded tool args.

Example:

"your input in plain text or JSON-encoded string"

result
string
required

Output — assistant reply or JSON-encoded tool result.

Example:

"your output in plain text or JSON-encoded string"

success
boolean

Defaults to true.

latency
integer

Execution time in ms.

Example:

5200

timestamp
integer<int64>

Unix time in ms when the event occurred. Defaults to server time.

Example:

1714867201000

parent_id
string<uuid>

Parent event UUID. Set on tool calls to point at the agent turn (or parent tool) that triggered them.

Example:

"4c7d2e8a-1b95-4f3d-a08e-7b3c9d12f5e6"

metadata
object

Free-form event metadata.

Example:

Response

Event recorded

event_id
string<uuid>