any framework

REST API

Integrate Neptrix governance into any custom agent or framework with a single POST request before each action.

API key required

You need a Neptrix API key to complete this setup. Sign up free to get one.

Installation

1Replace YOUR_API_KEY with your key
2Modify the plan fields to match your agent’s action
3Send the request before each agent action
4Check the response: ALLOW, BLOCK, ESCALATE, or MODIFY

Add this configuration toTerminal

Terminal

1curl -X POST https://qpthort-backend-production.up.railway.app/plans/submit \
2  -H "x-api-key: YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "plan_id": "plan-001",
6    "agent_id": "my-agent",
7    "task_id": "task-001",
8    "action_type": "WRITE",
9    "action_detail": {
10      "target": "/path/to/file",
11      "operation": "create",
12      "data_scope": ["SOURCE_CODE"],
13      "reversible": true,
14      "estimated_duration": "short"
15    },
16    "reasoning": "Creating a new configuration file",
17    "confidence": 0.9
18  }'

Replace YOUR_API_KEY with your API key. Sign up to get your key.

How it works

Agent proposes action

Before each tool call, your agent sends the proposed action to Neptrix for evaluation.

Neptrix evaluates

Constitutional governance rules evaluate the action. The decision is logged to your audit trail.

Decision returned

ALLOW, BLOCK, ESCALATE, or MODIFY. Agents auto-discover — no registration needed.

Ready to govern your agents?

Create a free account, generate an API key, and have governance running in under 5 minutes.

Get started for free