API reference · Trust Fabric

Register a principal

POST /fabric/identity/principals

Last reviewed 2026-10-02

POST /fabric/identity/principals

Request body

PrincipalCreate (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/identity/principals' \
  -H "X-API-Key: $CAIN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"kind": "kind", "display_name": "display-name"}'

import json, os, urllib.request

req = urllib.request.Request('https://cainstudio.online/fabric/identity/principals', method='POST',
    headers={"X-API-Key": os.environ["CAIN_API_KEY"], "Content-Type": "application/json"},
    data=json.dumps({
      "kind": "kind",
      "display_name": "display-name"
    }).encode())
with urllib.request.urlopen(req, timeout=60) as r:
    print(r.status, json.load(r))

const res = await fetch("https://cainstudio.online/fabric/identity/principals", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CAIN_API_KEY!,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "kind": "kind",
    "display_name": "display-name"
  }),
});
console.log(res.status, await res.json());

Schemas used

HTTPValidationError · PrincipalCreate · ValidationError

← List this tenant's principals · all 79 Trust Fabric calls · Fetch one principal →