CAIN-42 CAIN Studio

API reference · schema

MemberAdd

4 fields · used by 0 operations

Last reviewed 2026-10-02

Fields

FieldTypeMeaning
principal_idstring or nullan existing principal in this tenant
max length 200
emailstring or nullinvite by email; creates a pending human principal
max length 254
display_namestring or nullmax length 200
rolestringdefault "member"

Smallest valid example

{
  "role": "member"
}

JSON Schema

Show the raw definition
{
  "properties": {
    "principal_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Principal Id",
      "description": "an existing principal in this tenant"
    },
    "email": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 254
        },
        {
          "type": "null"
        }
      ],
      "title": "Email",
      "description": "invite by email; creates a pending human principal"
    },
    "display_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Display Name"
    },
    "role": {
      "type": "string",
      "title": "Role",
      "default": "member"
    }
  },
  "type": "object",
  "title": "MemberAdd"
}

Try CAIN-42 on your own agents

Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.

Create a free account →  ·  Try the sandbox  ·  See the whole ecosystem