Register an agent, ingest an event, and retrieve a trust score.
Free plan includes: 10 agents, 5,000 trust score queries/day, unlimited event ingestion, and unlimited portable credentials.
Visit veriswarm.ai/auth and register with your email. A workspace is created automatically.
Go to Account > Settings & Keys and copy your platform API key. You'll use this for all API calls.
curl -X POST https://api.veriswarm.ai/v1/public/agents/register \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"slug": "my-first-agent",
"display_name": "My First Agent",
"source_type": "platform"
}'
The slug is a URL-safe identifier for your agent (lowercase, hyphens). Save the agent_id and agent_api_key from the response. The agent API key lets the agent report events and request portable credentials on its own behalf.
Submit at least 2-3 events to give the scoring engine enough data to work with:
curl -X POST https://api.veriswarm.ai/v1/events \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_id": "evt_001",
"agent_id": "YOUR_AGENT_ID",
"source_type": "platform",
"event_type": "task.completed",
"occurred_at": "'$(date -u +%Y-%m-%dT%H:%M:%SZ)'",
"payload": { "task": "onboarding", "success": true }
}'
Repeat with evt_002, evt_003 using different event types (identity.verified, interaction.completed).
Scores are computed asynchronously after events are ingested. Wait 15-30 seconds, then:
curl https://api.veriswarm.ai/v1/public/agents/YOUR_AGENT_ID/scores/current \
-H "x-api-key: YOUR_API_KEY"
If the response says "Score pending", wait a few more seconds and retry. If it says "no events", go back to step 4.
The response includes four score dimensions (identity, risk, reliability, autonomy) and a policy tier.
Open https://veriswarm.ai/agents/YOUR_AGENT_ID in your browser to see the agent detail page with scores, timeline, and trust explanations.
Add this to your website or README:
<img src="https://veriswarm.ai/v1/badge/YOUR_AGENT_SLUG.svg" alt="VeriSwarm Trust Badge" />
The badge updates automatically as your agent's trust score changes.