Events

The producer route. One event in, one gate decision out, one ledger record written.

Method	Path	Scope	Summary
POST	/events/	events:write	Ingest Event

Try it

curl -sf -X POST "$VIGIL_URL/agents/" -H "Authorization: Bearer $VIGIL_KEY" -H "Content-Type: application/json" \
  -d '{"agent_id":"docs-api","name":"Docs API"}' > /dev/null || true
curl -sf -X POST "$VIGIL_URL/events/" -H "Authorization: Bearer $VIGIL_KEY" -H "Content-Type: application/json" \
  -d '{"agent_id":"docs-api","event_type":"output_generated","payload":{"content_length":512},"dti":0.9}'

Routes

POST /events/

Ingest Event. Scope: events:write.

Request body:

{
  "agent_id": "string",
  "event_type": "evaluation_score | config_read | config_write | file_operation | monitoring_state_change | output_generated",
  "payload": {},
  "dti": 0,
  "source": "self | platform_hook | otel | change_feed | vigil",
  "actor": "string | null"
}

Field	Type	Required	Notes
agent_id	string	yes
event_type	evaluation_score, config_read, config_write, file_operation, monitoring_state_change, output_generated	yes
payload	Payload	yes
dti	number | null	no
source	self, platform_hook, otel, change_feed, vigil	no
actor	string | null	no

Response 200:

{
  "event_id": 0,
  "action_id": 0,
  "gate_status": "pass | hold | alert | collapse",
  "bii": 0,
  "composite_trust": 0,
  "reason": "string",
  "requires_human_review": true
}

Generated from openapi.json (VIGIL 0.2.0). Scopes follow the router dependencies in VIGIL_SPEC.md section 4.2.