API reference · schema

CreateEdgeRequest

11 fields · used by 0 operations

Last reviewed 2026-10-06

Fields

Field	Type	Meaning
`from_node` required	string
`to_node` required	string
`relation_type` required	string
`provenance_source`	string	default `"system"`
`provenance_decision_id`	string or null
`provenance_evidence_id`	string or null
`provenance_policy_version`	integer or null
`provenance_trust_version`	integer or null
`provenance_correlation_id`	string or null
`weight`	number	default `1.0`
`properties`	object

Smallest valid example

{
  "from_node": "from-node",
  "to_node": "to-node",
  "relation_type": "relation-type",
  "provenance_source": "system",
  "weight": 1.0
}

JSON Schema

Show the raw definition

{
  "properties": {
    "from_node": {
      "type": "string",
      "title": "From Node"
    },
    "to_node": {
      "type": "string",
      "title": "To Node"
    },
    "relation_type": {
      "type": "string",
      "title": "Relation Type"
    },
    "provenance_source": {
      "type": "string",
      "title": "Provenance Source",
      "default": "system"
    },
    "provenance_decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance Decision Id"
    },
    "provenance_evidence_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance Evidence Id"
    },
    "provenance_policy_version": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance Policy Version"
    },
    "provenance_trust_version": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance Trust Version"
    },
    "provenance_correlation_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provenance Correlation Id"
    },
    "weight": {
      "type": "number",
      "title": "Weight",
      "default": 1.0
    },
    "properties": {
      "additionalProperties": true,
      "type": "object",
      "title": "Properties"
    }
  },
  "type": "object",
  "required": [
    "from_node",
    "to_node",
    "relation_type"
  ],
  "title": "CreateEdgeRequest"
}

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