CAIN-42 CAIN Studio

API reference · schema

ControlDefine

11 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

FieldTypeMeaning
name requiredstring
description requiredstring
category requiredstring
assertion_levelstringdefault "technical_control_verified"
control_logic requiredstring
inputs_requiredarray of stringdefault []
evaluation_method requiredstring
frameworksarray of stringdefault []
requirement_idsarray of stringdefault []
versionstringdefault "1.0"
requires_legal_mappingbooleandefault false

Smallest valid example

{
  "name": "name",
  "description": "description",
  "category": "category",
  "assertion_level": "technical_control_verified",
  "control_logic": "control-logic",
  "inputs_required": [],
  "evaluation_method": "evaluation-method",
  "frameworks": [],
  "requirement_ids": [],
  "version": "1.0",
  "requires_legal_mapping": false
}

Used by 1 operation

POST/fabric/compliance/controlsDefine Control

JSON Schema

Show the raw definition
{
  "properties": {
    "name": {
      "type": "string",
      "title": "Name"
    },
    "description": {
      "type": "string",
      "title": "Description"
    },
    "category": {
      "type": "string",
      "title": "Category"
    },
    "assertion_level": {
      "type": "string",
      "title": "Assertion Level",
      "default": "technical_control_verified"
    },
    "control_logic": {
      "type": "string",
      "title": "Control Logic"
    },
    "inputs_required": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Inputs Required",
      "default": []
    },
    "evaluation_method": {
      "type": "string",
      "title": "Evaluation Method"
    },
    "frameworks": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Frameworks",
      "default": []
    },
    "requirement_ids": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Requirement Ids",
      "default": []
    },
    "version": {
      "type": "string",
      "title": "Version",
      "default": "1.0"
    },
    "requires_legal_mapping": {
      "type": "boolean",
      "title": "Requires Legal Mapping",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "name",
    "description",
    "category",
    "control_logic",
    "evaluation_method"
  ],
  "title": "ControlDefine"
}

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