Reins Developer Docs

POST /api/policy-rules
Authorization: Bearer rk_abc123
{
  "name": "Block transactions over $5",
  "priority": 1,
  "enabled": true,
  "conditions": {
    "amountCents": { "min": 501 },
    "vendors": ["openai","anthropic","cohere","mistral","google","perplexity"]
  },
  "action": "block",
  "actionConfig": { "message": "Individual transactions over $5 are not permitted." }
}

const { reins } = require('reins-sdk');
const client = reins({ apiKey: process.env.REINS_API_KEY });

const result = await client.submitTransaction({
  amount: 600, // $6.00 — over the $5 limit
  vendor: 'openai',
  model: 'gpt-4'
});

if (result.action === 'block') {
  console.error('Blocked:', result.policyResult.message);
}

// Support bot: $500/mo hard cap
POST /api/policy-rules
{
  "name": "Support bot monthly cap",
  "priority": 20,
  "conditions": {
    "agentIds": ["support-bot"],
    "vendors": ["openai","anthropic"],
    "timeWindow": "monthly"
  },
  "action": "block",
  "actionConfig": { "message": "Support bot monthly budget exhausted ($500/mo)" }
}

// Data enrichment: warn at 80%
{
  "name": "Data enrichment 80% warning",
  "priority": 20,
  "conditions": { "agentIds": ["data-enrichment"], "timeWindow": "monthly" },
  "action": "warn",
  "actionConfig": { "message": "80% of monthly budget used", "thresholdPct": 80 }
}

await client.submitTransaction({
  amount: 200,
  vendor: 'openai',
  model: 'gpt-4',
  agentId: 'support-bot', // Required for per-agent policies
  userId: 'user-123'
});

// Block more than 50 requests per hour
{
  "name": "Hourly burst protection",
  "priority": 30,
  "conditions": {
    "vendors": ["openai","anthropic","cohere","mistral","google","perplexity"],
    "timeWindow": "hourly"
  },
  "action": "block",
  "actionConfig": { "message": "Hourly request limit (50/hour) exceeded", "maxTransactions": 50 }
}

// Warn at 80% of daily $100 budget
{
  "name": "Daily budget warning at 80%",
  "priority": 10,
  "conditions": { "vendors": ["openai","anthropic"], "timeWindow": "daily" },
  "action": "warn",
  "actionConfig": { "message": "Daily budget 80% exhausted", "thresholdPct": 80 }
}

// Block non-approved vendors (priority 100)
{
  "name": "Vendor allowlist",
  "priority": 100,
  "conditions": {
    "vendors": ["google","perplexity","cohere","mistral"],
    "amountCents": { "min": 1 }
  },
  "action": "block",
  "actionConfig": { "message": "Vendor not on approved list. Contact your admin." }
}

// Allow OpenAI and Anthropic (priority 1)
{
  "name": "Allow approved vendors",
  "priority": 1,
  "conditions": { "vendors": ["openai","anthropic"] },
  "action": "pass"
}

{
  "name": "Organization monthly cost cap",
  "priority": 200,
  "conditions": {
    "vendors": ["openai","anthropic","cohere","mistral","google","perplexity"],
    "amountCents": { "min": 1 },
    "timeWindow": "monthly"
  },
  "action": "block",
  "actionConfig": {
    "message": "Monthly AI spend cap reached ($2,000). Resets 1st of next month.",
    "thresholdPct": 100
  }
}

// Tiered: warn at 70% ($1,400) — warn at 90% ($1,800) — block at 100% ($2,000)

// Priority 100: Free users — no gpt-4
{ "name": "Free: no gpt-4", "priority": 100,
  "conditions": { "userRoles": ["free"], "models": ["gpt-4","gpt-4o"] },
  "action": "block", "actionConfig": { "message": "Upgrade to Pro to use gpt-4" } }

// Priority 90: Free users — $5/day hard cap
{ "name": "Free: $5/day", "priority": 90,
  "conditions": { "userRoles": ["free"], "timeWindow": "daily", "amountCents": { "min": 501 } },
  "action": "block", "actionConfig": { "message": "Daily limit reached. Upgrade for more." } }

// Priority 80: Trial users — warn at 80% monthly
{ "name": "Trial: 80% warning", "priority": 80,
  "conditions": { "userRoles": ["trial"], "timeWindow": "monthly" },
  "action": "warn", "actionConfig": { "message": "Trial budget 80% used", "thresholdPct": 80 } }

// Priority 10: Hard cap — no single transaction over $50
{ "name": "Hard cap: $50 max", "priority": 10,
  "conditions": { "amountCents": { "min": 5001 } },
  "action": "block", "actionConfig": { "message": "Exceeds $50 limit" } }

// Priority 1: Pass everything else
{ "name": "Default: pass", "priority": 1,
  "conditions": { "amountCents": { "min": 1 } },
  "action": "pass" }