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/sdk
POST

/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.

Tier 2 Gate
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.
1