# Capsule Security Webhook Events API

Real-time event ingestion for AI agent security monitoring.
Send agent lifecycle events to Capsule's detection pipeline for prevention and observability.


Version: 1.0.0
License: Proprietary

## Servers

Production API server
```
https://api.capsule.security
```

Staging API server
```
https://staging.api.capsule.security
```

## Security

### bearerAuth

JWT Bearer token for API access

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Capsule Security Webhook Events API](https://docs.capsulesecurity.io/_bundle/apis/webhook-events.yaml)

## Webhook Events

### Send webhook event

 - [POST /v1/generic-webhook/hooks/events](https://docs.capsulesecurity.io/apis/webhook-events/webhook-events/sendwebhookevent.md): Ingests agent lifecycle events for security analysis.
Blocking events (tool_invocation, user_message) return an allow/block decision.
Observational events (tool_result, agent_message, session_start, session_end) return 202 Accepted.