API Documentation

Everything you need to integrate your AI agents with Vector Decisions.

Quick Start

Get up and running in 5 minutes. Register your first agent and send events.

API Reference

Complete API documentation for all endpoints. Authentication, agents, events, decisions.

Integrations

Code examples for Python, Node.js, and other languages. Webhook setup guide.

Base URL

https://vectordecisions.com/api/v1

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from Settings > API in your dashboard.

curl -X POST https://vectordecisions.com/api/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Agent-ID: YOUR_AGENT_ID" \
  -H "Content-Type: application/json" \
  -d '{"eventType": "ACTION", "action": "Processed request", "category": "READ"}'

Endpoints

POST
/api/v1/agents— Register a new agent
PATCH
/api/v1/agents/:id— Update agent info
GET
/api/v1/agents/:id/status— Poll agent status (kill switch)
GET
/api/v1/agents/:id/instructions— Get agent instructions
POST
/api/v1/events— Log an event
POST
/api/v1/events/batch— Log multiple events (max 100)
POST
/api/v1/decisions— Log a decision
POST
/api/v1/health— Submit health check