Emit Event
curl --request POST \
--url https://api.truthlocks.com/v1/events \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"actor_id": "<string>",
"actor_type": "<string>",
"event_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({actor_id: '<string>', actor_type: '<string>', event_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/events"
payload = {
"actor_id": "<string>",
"actor_type": "<string>",
"event_type": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/events"
payload := strings.NewReader("{\n \"actor_id\": \"<string>\",\n \"actor_type\": \"<string>\",\n \"event_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "<string>",
"event_type": "<string>",
"agent_id": "<string>",
"resource_id": "<string>",
"severity": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Observability
Emit Event
Emit a service observability event for auditing, alerting, and operational monitoring.
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 '
{
"actor_id": "<string>",
"actor_type": "<string>",
"event_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({actor_id: '<string>', actor_type: '<string>', event_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/events"
payload = {
"actor_id": "<string>",
"actor_type": "<string>",
"event_type": "<string>"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/events"
payload := strings.NewReader("{\n \"actor_id\": \"<string>\",\n \"actor_type\": \"<string>\",\n \"event_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "<string>",
"event_type": "<string>",
"agent_id": "<string>",
"resource_id": "<string>",
"severity": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}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:
| 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 |
Response
Body
application/json

