Platform Overview
Vorantiq is an enterprise autonomous AI operating environment. The REST API gives you programmatic access to agents, workflows, intelligence cycles, observability, and billing — all secured with session-based authentication and full audit logging.
Quick Start
1. Create an account
Register via the API or at vorantiq.dev/register.
POST /api/auth/register
Content-Type: application/json
{
"email": "you@company.com",
"password": "your-password-min-8-chars",
"full_name": "Jane Smith",
"tenant_name": "Acme Corp"
}2. Sign in
POST /api/auth/login
Content-Type: application/json
{
"email": "you@company.com",
"password": "your-password"
}On success the server sets two HttpOnly cookies: vorantiq_token (15 min) and vorantiq_refresh_token (7 days). All subsequent requests must include these cookies.
3. Make your first authenticated request
curl https://api.vorantiq.dev/api/auth/me \
--cookie "vorantiq_token=YOUR_TOKEN"{
"user_id": "550e8400-e29b-41d4-a716-446655440000",
"email": "you@company.com",
"full_name": "Jane Smith",
"role": "admin",
"tenant_id": "550e8400-e29b-41d4-a716-446655440001",
"is_active": true
}Authentication
Vorantiq uses secure HttpOnly session cookies. Tokens are never exposed to JavaScript and are automatically refreshed. All auth routes are at /api/auth/.
/api/auth/registerCreate a new user account and tenant
/api/auth/loginAuthenticate and receive session cookies
/api/auth/logoutRevoke session and clear cookies
/api/auth/meGet current authenticated user details
/api/auth/refreshRotate access token using refresh token
/api/auth/forgot-passwordInitiate password reset email flow
/api/auth/reset-passwordComplete password reset with token
/api/auth/change-passwordChange password for authenticated user
Session lifecycle
Access tokens expire after 15 minutes. The frontend automatically calls /api/auth/refresh using the 7-day refresh token. On token rotation, the old refresh token is immediately invalidated. All sessions are revoked when you change your password.
Agents API
Create, deploy, and manage autonomous AI agents. Each agent belongs to your tenant and runs in the Vorantiq runtime orchestration layer.
/api/v1/agentsList all agents for your tenant
/api/v1/agentsCreate a new agent
/api/v1/agents/{id}Get agent by ID
/api/v1/agents/{id}Delete an agent
Create an agent
POST /api/v1/agents
Content-Type: application/json
{
"name": "Support Triage Agent",
"description": "Routes incoming support tickets to the right team",
"model": "claude-sonnet-4-6",
"capabilities": ["classify", "route", "notify"]
}Workflows API
Orchestrate multi-step DAG workflows that connect agents, triggers, and external systems.
/api/v1/workflowsList all workflows for your tenant
/api/v1/workflowsCreate a new workflow
/api/v1/workflows/{id}Get workflow details and run history
Errors & Rate Limits
Error format
All errors return a consistent JSON body:
{
"detail": "Human-readable error message"
}HTTP status codes
200OK — Request succeeded400Bad Request — Invalid input, validation failed401Unauthorized — Missing or expired session403Forbidden — Insufficient permissions404Not Found — Resource does not exist422Unprocessable Entity — Schema validation error429Too Many Requests — Rate limit exceeded500Internal Server Error — Contact support if persistsRate limits
API requests are rate-limited per tenant. Check headers on any response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 2026-03-30T15:00:00ZEnvironments
https://api.vorantiq.devLive production backend. Use your real credentials.
https://vorantiq.devControl plane UI. Login, manage agents, view intelligence.
Need help?
Email support@vorantiq.dev or to access the full platform and interactive API explorer.