Skip to main content
Varixen
Integration Reference

REST API & SDK Technical Reference (v4.0)

Updated July 10, 20268 min read

Complete endpoint documentation for model inference, agent execution, vector search, and webhooks.

1. Bearer Token Authentication

All HTTP requests to Varixen API endpoints must include a valid API Bearer token in the `Authorization` header.

bashvarixen-cli
curl -X POST https://api.varixen.com/v4/agents/run \
  -H "Authorization: Bearer vrx_live_9f8d7c6b5a4e3" \
  -H "Content-Type: application/json" \
  -d '{"agentId": "ag_sales_copilot", "input": "Prepare pre-call brief for Acme Corp"}'

2. Agent Execution POST /v4/agents/run

Triggers an autonomous multi-step agent execution returning streaming event tokens or a final JSON response object.

ParameterTypeRequiredDescription
agentIdstringYesUnique identifier of configured AI agent
inputstringYesNatural language user prompt or JSON payload
streambooleanNoSet true for Server-Sent Events (SSE) streaming

3. Vector Query POST /v4/vectors/search

Queries the enterprise hybrid RAG index combining semantic vector similarity with keyword BM25 filtering.

Ready to build what's next?

Schedule a 1-on-1 Digital Transformation Strategy Call with our leadership team to accelerate your technology roadmap.