API reference · schema

DriftFindingResponse

26 fields · used by 2 operations

Last reviewed 2026-10-03

Fields

Field	Type	Meaning
`drift_id` required	string
`drift_class` required	string
`tenant` required	string
`agent_id`	string or null
`timestamp` required	string
`metric` required	string
`baseline_value` required	number
`current_value` required	number
`delta` required	number
`delta_percent` required	number
`threshold` required	number
`confidence` required	number
`sample_size` required	integer
`method` required	string
`severity` required	string
`verdict` required	string
`explanation` required	string
`policy_id`	string or null
`evidence_id`	string or null
`correlation_id`	string or null
`trajectory_id`	string or null
`trust_impact`	boolean	default `false`
`compliance_impact`	boolean	default `false`
`recommended_action` required	string
`affected_systems`	array of string
`status`	string	default `"detected"`

Smallest valid example

{
  "drift_id": "drift-id",
  "drift_class": "drift-class",
  "tenant": "tenant",
  "timestamp": "timestamp",
  "metric": "metric",
  "baseline_value": 1.0,
  "current_value": 1.0,
  "delta": 1.0,
  "delta_percent": 1.0,
  "threshold": 1.0,
  "confidence": 1.0,
  "sample_size": 1,
  "method": "method",
  "severity": "severity",
  "verdict": "verdict",
  "explanation": "explanation",
  "trust_impact": false,
  "compliance_impact": false,
  "recommended_action": "recommended-action",
  "status": "detected"
}

Used by 2 operations

GET	`/fabric/drift/findings`	List Findings
GET	`/fabric/drift/findings/{drift_id}`	Get Finding

JSON Schema

Show the raw definition

{
  "properties": {
    "drift_id": {
      "type": "string",
      "title": "Drift Id"
    },
    "drift_class": {
      "type": "string",
      "title": "Drift Class"
    },
    "tenant": {
      "type": "string",
      "title": "Tenant"
    },
    "agent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent Id"
    },
    "timestamp": {
      "type": "string",
      "title": "Timestamp"
    },
    "metric": {
      "type": "string",
      "title": "Metric"
    },
    "baseline_value": {
      "type": "number",
      "title": "Baseline Value"
    },
    "current_value": {
      "type": "number",
      "title": "Current Value"
    },
    "delta": {
      "type": "number",
      "title": "Delta"
    },
    "delta_percent": {
      "type": "number",
      "title": "Delta Percent"
    },
    "threshold": {
      "type": "number",
      "title": "Threshold"
    },
    "confidence": {
      "type": "number",
      "title": "Confidence"
    },
    "sample_size": {
      "type": "integer",
      "title": "Sample Size"
    },
    "method": {
      "type": "string",
      "title": "Method"
    },
    "severity": {
      "type": "string",
      "title": "Severity"
    },
    "verdict": {
      "type": "string",
      "title": "Verdict"
    },
    "explanation": {
      "type": "string",
      "title": "Explanation"
    },
    "policy_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Policy Id"
    },
    "evidence_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Evidence Id"
    },
    "correlation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Correlation Id"
    },
    "trajectory_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Trajectory Id"
    },
    "trust_impact": {
      "type": "boolean",
      "title": "Trust Impact",
      "default": false
    },
    "compliance_impact": {
      "type": "boolean",
      "title": "Compliance Impact",
      "default": false
    },
    "recommended_action": {
      "type": "string",
      "title": "Recommended Action"
    },
    "affected_systems": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Affected Systems"
    },
    "status": {
      "type": "string",
      "title": "Status",
      "default": "detected"
    }
  },
  "type": "object",
  "required": [
    "drift_id",
    "drift_class",
    "tenant",
    "timestamp",
    "metric",
    "baseline_value",
    "current_value",
    "delta",
    "delta_percent",
    "threshold",
    "confidence",
    "sample_size",
    "method",
    "severity",
    "verdict",
    "explanation",
    "recommended_action"
  ],
  "title": "DriftFindingResponse"
}

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