eventHandler | GraphQL reference

eventHandler

returns EventHandler

One event handler, or null.

Arguments

Name	Type	Description
id	String!	The handler's id (`hdl_`-prefixed).

Returns EventHandler

A rule that turns a matching event into GL rows.

Field	Type	Description
id	String!	Handler id (`hdl_`-prefixed).
name	String!	Human-readable handler name.
description	String	What the handler is for.
eventType	String!	The event type the handler matches.
eventCategory	String	Match on the event's category; null matches any.
matchSource	String	Match on the event's source system; null matches any.
matchAgentType	String	Match on the counterparty's role; null matches any.
matchResourceType	String	Match on the resource type; null matches any.
matchMetadataExpression	JSON	Equality matches against the event's metadata.
transactionTemplate	JSON!	The GL rows the handler books: its DSL template, as JSON.
priority	Int!	Among handlers that match, the highest priority wins.
isActive	Boolean!	Whether the handler takes part in matching at all.
origin	String!	`hub` for a platform-shipped handler, `tenant` otherwise.
suggestedBy	String	`ai` when an AI client created the handler or last changed what it matches or books; null when a person did.
confidence	Float	The suggesting AI's confidence, when it gave one.
approvedBy	String	The user who approved an AI-suggested handler.
approvedAt	DateTime	When it was approved.
awaitingApproval	Boolean!	True for an AI-suggested handler no one has approved: it takes no part in matching until a person approves it.
createdAt	DateTime	When it was created.
updatedAt	DateTime	When it last changed.
createdBy	String	The user who created it.

Example

query

{ eventHandler(id: "rec_...") { id name description eventType } }

curl

curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ eventHandler(id: \"rec_...\") { id name description eventType } }"}'