Documentation

Start ingesting events in minutes and use returned proof fields for downstream verification workflows.

Quickstart

1. Create an organization and securely store your API key.

2. Register agents and metadata used for runtime attribution.

3. Send events to `POST /api/v1/events` using Bearer auth.

4. Use proof fields in dashboards, alerting, and audit workflows.

Verification Checklist

Validate `proofHash` against your canonical payload format.

Verify chain continuity with `chainHash`, `previousHash`, and sequence values.

Confirm attestation state through `constellationVerificationUrl` when enabled.

Export evidence package for internal and external review teams.

Sample Request

curl -X POST https://your-domain.com/api/v1/events \
  -H "Authorization: Bearer as_live_***" \
  -H "Content-Type: application/json" \
  -d '{
    "externalEventId": "evt_12345",
    "agentId": "agent_abc123",
    "action": "Evaluate outbound transfer",
    "actionCategory": "decision",
    "model": "gpt-4.1",
    "modelProvider": "openai",
    "status": "verified",
    "confidence": 0.86,
    "latencyMs": 1490,
    "inputContent": "User requested wire transfer...",
    "outputContent": "Transfer denied due to policy...",
    "tags": ["finance", "payment"],
    "timestamp": 1760400000000
  }'

Sample Response

{
  "eventId": "evt_convex_id",
  "proofHash": "sha256_hex",
  "chainHash": "sha256_hex",
  "constellationStatus": "confirmed",
  "constellationVerificationUrl": "https://..."
}