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:

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

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
event_type
string
required

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

agent_id
string

MAIP agent identifier associated with the event

resource_id
string

Identifier of the resource affected by the event

metadata
object

Arbitrary key-value metadata providing additional context

severity
enum<string>
default:info

Event severity level

Available options:
info,
warn,
error

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>