admin
hook-events

List Engagement Hook Events

Return hook evaluation/action log lines for an engagement.

Backed by SigNoz log queries — see api/utils/signoz_read.py. Returns [] when SigNoz is not configured, the engagement doesn't exist, or the caller isn't authorized for the engagement's org. The handler decides authorization; the router just shapes the response.

The signoz_read parser already coerces timestamps to datetime, so unmappable rows are dropped at the source rather than silently discarded here on integer-timestamp surprises.

get/admin/engagements/{engagement_id}/hook-events

Request

  • Base URL
    https://api-docs.upsmith.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

engagement_idstring required

Headers

organization-idstring nullable
timezonestring
x-user-idstring nullable
x-actor-emailstring nullable
x-request-sourcestring nullable
x-operation-idstring nullable
x-commit-messagestring nullable
x-confirmation-idstring nullable
x-chat-idstring nullable

Response

Successful Response

timestampstring date-time required
trace_idstring nullable
bodystring nullable
loggerstring nullable
hook_idstring nullable
hook_namestring nullable
hook_triggerstring nullable
outcomestring nullable
matchedboolean nullable
actions_plannedstring[]
action_typestring nullable
tool_namestring nullable
error_typestring nullable
error_messagestring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.