API-First Reference Specification
Multi-Modular API Protocol & SDK
Comprehensive REST, OpenAPI 3.1, and Model Context Protocol (MCP) documentation. Explore canonical ActionIntents, Anycast DNS endpoints, Edge Workers, and S3-compatible storage.
Base URL
https://api.vaulthost.cloud/v1
OpenAPI 3.1 Spec/api/openapi.json
AI Agent Protocol
MCP JSON-RPC 2.0
Idempotency SLA
24h Safe Replay Protection
Endpoints Directory
Official SDK Package
Install the official multi-modular client SDK for Node.js, Bun, and browser edge environments:
npm install @vaulthost/sdkPOST
/api/action-gateway/intent
The core decoupled boundary. Autonomous AI agents emit declarative ActionIntents. Gateway enforces Risk Tiers (0-3), calculates HMAC-SHA256 signature, and enforces blast radius safety.
Required Headers
Authorization:Bearer vh_live_9f83a8b27c1094ea
Content-Type:application/json
X-VaultHost-Tenant:tenant_prod_01
Idempotency-Key:intent_9f81a702-8b4e-4e3a
Client Implementation
example-request.sh
curl -X POST "https://api.vaulthost.cloud/v1/api/action-gateway/intent" \
-H "Authorization: Bearer vh_live_9f83a8b27c1094ea" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: intent_9f81a702-8b4e-4e3a" \
-d '{"intentId":"int_9f81...","targetService":"dns","actionVerb":"purge_cache"}'Tests execute with sandbox credentials against the local cluster.