Skip to main content
POST
/
v1
/
events
Emit Event
curl --request POST \
  --url https://api.truthlocks.com/v1/events \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "event_type": "<string>",
  "agent_id": "<string>",
  "resource_id": "<string>",
  "metadata": {},
  "severity": "info"
}
'
{
  "id": "<string>",
  "event_type": "<string>",
  "agent_id": "<string>",
  "resource_id": "<string>",
  "severity": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}
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:
CategoryEvent Types
Agentagent.registered, agent.updated, agent.suspended, agent.revoked, agent.restored
Sessionsession.created, session.refreshed, session.expired, session.revoked
Trusttrust.computed, trust.threshold_breach, trust.delegation_offered, trust.delegation_accepted, trust.delegation_expired
Orchestrationorchestration.started, orchestration.completed, orchestration.failed, orchestration.timeout
Datasetdataset.attested, dataset.lineage_updated
Modelmodel.attested, model.lineage_updated
Guardrailguardrail.violation, guardrail.circuit_breaker_opened, guardrail.circuit_breaker_closed
Anomalyanomaly.reported, anomaly.resolved
Kill Switchkillswitch.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.

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>