Holiday offer: AI Agent Gap Check — $2,500, results in 5 business days →
Rends

Documentation

Rends documentation: SDKs, approval holds and emergency stop

A complete reference for the four-engine architecture (Discover, Translate, Govern, Comply), the enterprise features, SDKs, and the regulatory coverage that backs the platform. Base URL https://rends.ai/api/v1.

01

Getting started

Every request targets the gateway base URL https://rends.ai/api/v1. Authenticate with either a session JWT (dashboard flows) or an API key issued from Settings → API Keys. All API keys begin with ac_live_.

Quick start: your first check-action call

The fastest path from zero to a live compliance decision is a single POST to the Comply engine.

cURL — first check-action

curl -sS -X POST "https://rends.ai/api/v1/compliance/check-action" \
  -H "Authorization: Bearer ac_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_123",
    "agentId": "agent_456",
    "actionType": "tool_call",
    "actionName": "send_email",
    "resourceType": "external_api",
    "input_summary": "Drafting outbound message to customer"
  }'

The response includes a decision (allow, warn, or block), the triggered rules, and a request ID you can match against the audit trail.

Authentication

  • API keys — Authorization: Bearer ac_live_…. Used for engine routes (agents, governance, compliance). Cannot call gateway-owned routes such as /v1/billing or/v1/api-keys.
  • Session JWT — Authorization: Bearer <session_jwt>. Issued by our self-hosted identity service and used by the dashboard; the gateway requires organization context.

Base URL & versioning

All public routes are versioned under /v1. This page documents the API surface; the machine-readable OpenAPI 3.1 spec is not currently published to a public URL. Ask us if you need the spec file.

02

Platform overview

Four-engine architecture

Discover

Shadow AI inventory

8 scan types (packages, lockfiles, source, DNS, cloud audit, env, HTTP egress, processes), 25 AI provider signatures, 4 confidence levels. Public Scanner Lite — no SDK required.

Translate

Regulation → policy

7 control templates, custom regulations support, about 1¢ per draft on Haiku. Approved drafts deploy as govern.access_policies rows automatically via the deploy bridge.

Govern

Runtime enforcement

Access policies, prompt-injection detection, conditional access, retention, kill switch, HITL, distributed enforcement mesh with pub/sub reload.

Comply

Evidence + audit

51 regulations tracked, hash-chained audit trails (SHA-512), AICAP™ passports.

Tier overview

TierPriceHighlights
Starter$1,500/moUsage events, agent lifecycle, four-engine core, public Scanner Lite.
Professional$7,500/mo+ prompt-injection, content safety, bias, drift, scorecards, artifacts.
Enterprise$25,000+/mo+ conditional access, retention, dependency mapping.

All plans include a 14-day trial; onboarding is by request.

03

Deploy service (internal)

Deploy is platform plumbing — the internal service (port 4001) that handles agent registration, lifecycle transitions, and the dependency graph used by blast-radius analysis. Customer-facing positioning is the four engines above; Deploy is the substrate they all share.

Agents

POST/v1/agents
GET/v1/agents
GET/v1/agents/:id

Lifecycle (F10)

Agents move through five stages: planned → active → deprecated → retired → archived. Every transition is recorded as an event.

POST/v1/agents/:id/lifecycle
GET/v1/agents/:id/lifecycle

Body — POST /v1/agents/:id/lifecycle

{
  "to_stage": "deprecated",
  "reason": "Superseded by v2 retrieval agent",
  "successor_agent_id": "agent_abc123",
  "metadata": { "ticket": "GOV-481" }
}

Dependencies (F11, T2)

Declare upstream/downstream dependencies between agents and the systems they touch, then query the impact graph.

POST/v1/agents/:id/dependencies
GET/v1/agents/:id/dependencies
GET/v1/agents/:id/dependencies/impact
PATCH/v1/dependencies/:id
DELETE/v1/dependencies/:id

04

Govern engine

The Govern engine (port 4002) enforces runtime policy: prompt-injection detection, conditional access, retention, the kill switch, HITL approvals, and anomaly detection.

Prompt injection pre-check (F7)

A 16-pattern detector with compound-boost scoring runs before any tool call. Severities arenone, low, medium, high, and critical. When the prompt_injection_detection flag is enabled, requests at high orcritical are blocked.

POST/v1/govern/check-action

Example response

{
  "decision": "block",
  "severity": "high",
  "score": 0.87,
  "patterns_matched": ["override_instructions", "exfiltrate_secrets"],
  "compound_boost": 0.15,
  "request_id": "req_01HW…"
}

Conditional access (F8, T2)

Build context-aware allow/deny policies (IP ranges, time windows, principal claims, resource tags) and evaluate them per call.

POST/v1/access-policies
GET/v1/access-policies
POST/v1/access-policies/evaluate
GET/v1/access-decisions

Retention policies (F9, T2)

Define data-retention rules per resource type, then trigger immediate enforcement or rely on the scheduled run.

POST/v1/retention/policies
GET/v1/retention/policies
POST/v1/retention/policies/:id/run
GET/v1/retention/executions

Kill switch, HITL, anomalies

The kill switch is available on every tier. Human-in-the-loop approvals and anomaly detection are Professional and Enterprise capabilities. See the dedicated guides for kill switch, HITL, and anomaly detection.

05

Comply engine

The Comply engine (port 4003) is the synchronous compliance gate plus the async evaluation pipeline. The check-action endpoint runs the full pipeline: F7 injection scan → F4 content safety → rules engine → F1 usage events.

Real-time and on-demand evaluation

POST/v1/compliance/check-action
POST/v1/compliance/evaluate

Body — POST /v1/compliance/check-action

{
  "orgId": "org_123",
  "agentId": "agent_456",
  "actionType": "tool_call",
  "actionName": "send_email",
  "resourceType": "external_api",
  "input_summary": "Outbound message to customer about refund"
}

Content safety (F4, T1+)

Per-call scan across toxicity, hate, harassment,self_harm, sexual, violence, profanity, andpii. Industry-gated detectors add PHI patterns for healthcare and PCI for financial. Detected PII is auto-redacted in content_preview before persistence.

Bias detection (F2, T1+)

v1 covers three dimensions — gender, race, and age — using keyword/lexicon analysis on agent outputs. Runs post-evaluation on a BullMQ worker so the synchronous path stays fast.

Drift monitoring (F3, T1+)

Z-score detection over daily baselines on latency, error_rate, andcompliance_score. Severities map to standard deviations:

  • < 1σ — info
  • 1–2σ — warn
  • 2–3σ — critical
  • > 3σ — emergency

Risk scorecards (F5, T1+)

Six dimensions roll up to a single grade: compliance, bias, drift,safety, prompt_injection, governance. Aggregated weekly via a BullMQ cron, with a SHA-512 verification hash for tamper evidence.

GradeScore band
A+≥ 95
A≥ 85
B≥ 70
C≥ 55
D≥ 40
F< 40

Compliance artifacts (F6, T1+)

Generate audit-ready Markdown documents on demand — system cards, model cards, DPAs, privacy policies, safety cases, and transparency reports. Each artifact ships with a SHA-512 verification hash.

POST/v1/compliance/artifacts/generate
GET/v1/compliance/artifacts
GET/v1/compliance/artifacts/:id

Supported types: system_card, model_card, dpa, privacy_policy, safety_case, transparency_report.

Usage analytics (F1, T0+)

Every meaningful action is recorded as a usage event, on every tier — including Starter.

  • compliance_check — every real-time check-action call
  • compliance_violation — rule failures
  • compliance_block — blocked outcomes
  • prompt_injection — F7 detections
  • content_safety — F4 scans
  • bias_detection — F2 results
  • drift_detection — F3 alerts
  • risk_scorecard — F5 weekly aggregates
  • agent_lifecycle — F10 transitions
  • compliance_artifact — F6 generations

Discover engine

Discover finds AI usage you didn't know about — through eight scan types covering packages, lockfiles, source code, DNS resolution, cloud audit trails, environment variables, HTTP egress and running processes. 25 AI provider signatures across vendors and SDKs; four confidence levels keep the noise down.

Public AI Exposure Scanner

The same detection logic backs the public, no-account-required scanner at /scanner. Submit a free-text description of your AI usage and get a structured exposure summary in under 10 seconds. Per-IP rate-limited and under a global daily LLM budget cap.

POST/v1/public/scanner

Authenticated discovery

For org-scoped scans across all eight detection channels, see the discovery routes:

POST/v1/shadow-scans
GET/v1/shadow-scans
POST/v1/shadow-scans/github-webhook

Translate engine

Translate converts regulations into structured policy drafts you can review, approve, and deploy. Each draft is generated from a regulation (Radar-discovered or org-custom) plus the org context, and emits a JSON artifact whose controls_to_apply array references the platform's seven control templates: human_oversight_gate, audit_log_required, data_classification_filter, model_allowlist, rate_limit_cap, output_content_policy, explainability_mandate. Cost runs about 1¢ per draft on Haiku.

Drafts CRUD + lifecycle

GET/v1/drafts
GET/v1/drafts/:id
POST/v1/drafts/:id/submit
POST/v1/drafts/:id/approve
POST/v1/drafts/:id/reject
POST/v1/drafts/:id/shadow
GET/v1/drafts/:id/shadow-report
POST/v1/drafts/:id/deploy
POST/v1/drafts/:id/supersede

Custom regulations

Author org-private regulations alongside the public ones — internal AI policies, contractual requirements, board mandates. Create + content-changing updates auto-enqueue a translation job through the same pipeline as Radar-sourced regulations.

POST/v1/custom-regulations
GET/v1/custom-regulations
GET/v1/custom-regulations/:id
PUT/v1/custom-regulations/:id
DELETE/v1/custom-regulations/:id

Deploy bridge — drafts to runtime controls

The deploy bridge is the link between Translate and Govern. When a draft transitions shadow → deployed, the bridge maps each control onto a row in govern.access_policies in a single transaction across schemas. Two of the seven templates (human_oversight_gate and explainability_mandate) map cleanly onto the strict access-policy conditions schema; the other five emit enabled = false stub rows for traceability so the deploy stays fully auditable and re-enable-able once richer enforcement engines (RPL, classification scanner, rate-limit table) land.

After commit, the bridge publishes on the Redis pub/sub channel govern:policies:invalidate. Every Govern instance subscribes and calls EnforcementMesh.notifyPolicyChange() so its in-process policy snapshot reloads atomically — no restart required. Supersede flips enabled = false across the rows by source_draft_id and publishes the same signal.

06

Feature flag gating

Every enterprise feature is gated by a flag and a tier. The gateway checks flags on every request; routes return 403 with AC-1004 when a flag is off for the calling org.

FeatureFlag keyStarterProEnterprise
Usage AnalyticsUsage data is captured today; customer-facing reporting is not yet available.usage_analytics
Agent Lifecycleagent_retirement
Prompt Injectionprompt_injection_detection
Content Safetycontent_safety
Bias Detectionbias_detection
Drift Monitoringdrift_monitoring
Risk Scorecardsrisk_scorecards
Compliance Artifactscompliance_artifacts
Conditional Accessconditional_access
Retention Policiesretention_policies
Dependency Mappingdependency_mapping

07

SDKs

Node.js

@rends/agent-sdk

npm install @rends/agent-sdk@2.0.0
Read the Node.js guide →

Python

rends-agent-sdk

pip install rends-agent-sdk==2.0.0
Read the Python guide →

Both SDKs wrap the same gateway base URL and share the same auth model. Source for both is generated from the OpenAPI spec.

Framework adapters

9 agent frameworks across the two published SDKs (2.0.0): Node — LangChain, OpenAI Agents and Google ADK; Python — LangChain, LangGraph, CrewAI, AutoGen, OpenAI Agents, Google ADK, Haystack, LlamaIndex and PydanticAI. Both SDKs also ship an OpenTelemetry adapter. Each adapter forwards chain_id, metadata.task_id, and per-call risk hints to the gateway automatically.

08

Regulatory coverage

The compliance catalog ships with 51 regulations across 20 jurisdictions. Rules are mapped to controls and to AICAP document types, so generating an artifact pulls in the right evidence automatically.

US Federal

NIST AI RMF · EO 14110 · FTC Act · ECOA · FCRA · HIPAA · GLBA · SOX · BSA/AML

US State

CCPA / CPRA · NY DFS 500 · Colorado AI Act · Illinois BIPA

EU & UK

EU AI Act · GDPR · UK AI Framework

International

Singapore FEAT · ISO 42001 · OECD AI Principles

09

AICAP framework

The AI Compliance Autonomous Platform (AICAP™) is the framework behind Rends' evidence. Its catalog maps 50 document types to the regulations that call for them, and each AICAP™ passport carries one of four levels, set from the agent's latest evaluation. A passport is a signed record you can share; anyone can look it up at rends.ai/verify.

Bronze

Foundational

Silver

Operational

Gold

Mature

Platinum

Leading

10

Interactive OpenAPI

Every endpoint above is documented with request/response schemas, examples, and AC-XXXX error codes. An interactive reference is not available on this page — the machine-readable spec is not published to a public URL. Ask us if you need it.

Docs: AI Agent SDKs, Approval Holds, Kill Switch | Rends