CAIN-42 CAIN Studio

API reference · schema

FindingCreate

8 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

FieldTypeMeaning
finding_id requiredstring
severity requiredstring
title requiredstring
description requiredstring
requirement_idstring or null
control_idstring or null
evidence_idsarray of stringdefault []
affected_assetstring or null

Smallest valid example

{
  "finding_id": "finding-id",
  "severity": "severity",
  "title": "title",
  "description": "description",
  "evidence_ids": []
}

Used by 1 operation

POST/fabric/compliance/findingsCreate Finding

JSON Schema

Show the raw definition
{
  "properties": {
    "finding_id": {
      "type": "string",
      "title": "Finding Id"
    },
    "severity": {
      "type": "string",
      "title": "Severity"
    },
    "title": {
      "type": "string",
      "title": "Title"
    },
    "description": {
      "type": "string",
      "title": "Description"
    },
    "requirement_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Requirement Id"
    },
    "control_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Control Id"
    },
    "evidence_ids": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Evidence Ids",
      "default": []
    },
    "affected_asset": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Affected Asset"
    }
  },
  "type": "object",
  "required": [
    "finding_id",
    "severity",
    "title",
    "description"
  ],
  "title": "FindingCreate"
}

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