Emit Event
Observability
Emit Event
Emit a service observability event for auditing, alerting, and operational monitoring.
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
Theevent_type field uses a dot-separated namespace. The following event types are supported:
Authentication
string
required
API key with
events:write scope. Alternatively, pass a Bearer JWT token in
the Authorization header.string
required
Tenant identifier for multi-tenant isolation.
Request
string
required
Dot-separated event type identifier (e.g.
agent.registered,
orchestration.completed). See the event types table above.string
MAIP agent identifier associated with the event, if applicable.
string
Identifier of the resource affected by the event (e.g. session ID,
orchestration ID, dataset ID).
object
Arbitrary key-value metadata providing additional context about the event.
string
Event severity level. Must be one of:
info, warn, error. Defaults to
info.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
API key for machine-to-machine authentication
Body
application/json
Dot-separated event type identifier (e.g. agent.registered, orchestration.completed)
MAIP agent identifier associated with the event
Identifier of the resource affected by the event
Arbitrary key-value metadata providing additional context
Event severity level
Available options:
info, warn, error 
