API reference · Trust Fabric

Ask the control plane to decide on a proposed action

POST /fabric/decisions

Last reviewed 2026-10-02

POST /fabric/decisions

Request body

DecisionRequest (required)

Responses

Try it

The request goes from your browser straight to this site. Your key is not stored unless you tick the box, and then only in this tab's session storage.

Code

curl -sS -X POST 'https://cainstudio.online/fabric/decisions' \
  -H "X-API-Key: $CAIN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"path": "/tools/send_email", "payload": {"to": "ops@example.com", "subject": "Weekly report"}, "agent_id": "my-agent", "chain_id": "run-001", "record": false, "provenance": {"to": "user"}}'

import json, os, urllib.request

req = urllib.request.Request('https://cainstudio.online/fabric/decisions', method='POST',
    headers={"X-API-Key": os.environ["CAIN_API_KEY"], "Content-Type": "application/json"},
    data=json.dumps({
      "path": "/tools/send_email",
      "payload": {
        "to": "ops@example.com",
        "subject": "Weekly report"
      },
      "agent_id": "my-agent",
      "chain_id": "run-001",
      "record": False,
      "provenance": {
        "to": "user"
      }
    }).encode())
with urllib.request.urlopen(req, timeout=60) as r:
    print(r.status, json.load(r))

const res = await fetch("https://cainstudio.online/fabric/decisions", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CAIN_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "path": "/tools/send_email",
    "payload": {
      "to": "ops@example.com",
      "subject": "Weekly report"
    },
    "agent_id": "my-agent",
    "chain_id": "run-001",
    "record": false,
    "provenance": {
      "to": "user"
    }
  }),
});
console.log(res.status, await res.json());

In application code the SDK wraps this call for you: @cainstudio.guard() on a function sends its name and arguments here and only runs it on ALLOW. See the Python SDK.

Schemas used

HTTPValidationError · ValidationError · DecisionRequest

← List this tenant's recent Fabric decisions · all 79 Trust Fabric calls · Live feed of this tenant's decisions (Server-Sent Events) →