Documentation

Quick start

1. Create an account and organization
2. Register an agent with a required human sponsor
3. Delegate scoped, expiring authority (action types + limits)
4. Create an API key in the console
5. Call evaluateAction before every agent action

Install SDK

Published on npm — @auctra/sdk

npm install @auctra/sdk

Evaluate an action

import { Auctra } from "@auctra/sdk";

const auctra = new Auctra({
  apiKey: process.env.AUCTRA_API_KEY,
  // defaults to https://console.auctra.tech
});

const decision = await auctra.evaluateAction({
  agentId: "your-agent-uuid",
  actionType: "send_payment",
  payload: { amount: 1200, currency: "USD" },
});

if (decision.decision === "allowed") {
  // proceed
} else if (decision.decision === "require_approval") {
  // pause for human review
} else {
  throw new Error(decision.reason);
}

Delegate authority via SDK

const validUntil = new Date();
validUntil.setDate(validUntil.getDate() + 30);

await auctra.createDelegation({
  agentId: "your-agent-uuid",
  actionTypes: ["send_payment"],
  maxAmount: 500,
  currency: "USD",
  validUntil: validUntil.toISOString(),
});

REST API

Base URL: https://console.auctra.tech
Auth: Authorization: Bearer YOUR_API_KEY

curl -X POST https://console.auctra.tech/v1/action-requests/evaluate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "your-agent-uuid",
    "actionType": "send_payment",
    "payload": { "amount": 100, "currency": "USD" }
  }'

Decision outcomes