Emit Event

Emit a service observability event for auditing, alerting, and operational monitoring.

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:

Category	Event Types
Agent	agent.registered, agent.updated, agent.suspended, agent.revoked, agent.restored
Session	session.created, session.refreshed, session.expired, session.revoked
Trust	trust.computed, trust.threshold_breach, trust.delegation_offered, trust.delegation_accepted, trust.delegation_expired
Orchestration	orchestration.started, orchestration.completed, orchestration.failed, orchestration.timeout
Dataset	dataset.attested, dataset.lineage_updated
Model	model.attested, model.lineage_updated
Guardrail	guardrail.violation, guardrail.circuit_breaker_opened, guardrail.circuit_breaker_closed
Anomaly	anomaly.reported, anomaly.resolved
Kill Switch	killswitch.activated

Authentication

X-API-Key · string · required

API key with events:write scope. Alternatively, pass a Bearer JWT token in the Authorization header.

X-Tenant-ID · string · required

Tenant identifier for multi-tenant isolation.

Request

event_type · string · required

Dot-separated event type identifier (e.g. agent.registered, orchestration.completed). See the event types table above.

agent_id · string

MAIP agent identifier associated with the event, if applicable.

resource_id · string

Identifier of the resource affected by the event (e.g. session ID, orchestration ID, dataset ID).

metadata · object

Arbitrary key-value metadata providing additional context about the event.

severity · string

Event severity level. Must be one of: info, warn, error. Defaults to info.

Response

id · string

Unique event identifier in MAIP format (maip-evt:ULID).

event_type · string

The event type emitted.

agent_id · string

Associated agent identifier.

resource_id · string

Associated resource identifier.

severity · string

Event severity level.

created_at · string

ISO 8601 timestamp of event creation.