Skip to main content
POST
Emit Event
Emits a structured observability event into the MAIP event stream. Events provide a unified audit trail of all significant actions across the machine-identity service — from agent registration and session lifecycle to trust computation and orchestration completion. Events are persisted with tenant isolation, indexed for fast querying, and available for webhook delivery, SIEM integration, and the metrics aggregation pipeline.

Event Types

The event_type field uses a dot-separated namespace. The following event types are supported:

Response

string
Unique event identifier in MAIP format (maip-evt:ULID).
string
The event type emitted.
string
Associated agent identifier.
string
Associated resource identifier.
string
Event severity level.
string
ISO 8601 timestamp of event creation.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
actor_id
string
required
actor_type
string
required
event_type
string
required

Dot-separated event type identifier (e.g. agent.registered, orchestration.completed)

payload
any
source_service
string
span_id
string | null
target_id
string | null
target_type
string | null
trace_id
string | null

Response

Event emitted successfully

id
string

Unique event identifier (maip-evt:ULID)

event_type
string
agent_id
string
resource_id
string
severity
string
created_at
string<date-time>