Skip to main content
GET
/
v1
/
observability
/
events
List Observability Events
curl --request GET \
  --url https://api.truthlocks.com/v1/observability/events \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "event_type": "<string>",
      "payload": {},
      "timestamp": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}
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

Query Parameters

​
agent_id
string<uuid>

Filter by agent

​
event_type
string

Filter by event type

​
from
string<date-time>

Start of time range (ISO 8601)

​
to
string<date-time>

End of time range (ISO 8601)

​
limit
integer
default:50
Required range: 1 <= x <= 500
​
offset
integer
default:0
Required range: x >= 0

Response

Paginated observability events

​
items
object[]
​
total
integer