API reference · schema

RecordProvenanceRequest

16 fields · used by 0 operations

Last reviewed 2026-10-06

Fields

Field	Type	Meaning
`envelope_id` required	string
`tool_id` required	string
`tool_version`	string or null
`mcp_server_id`	string or null
`mcp_server_version`	string or null
`model_provider`	string or null
`model_name`	string or null
`model_version`	string or null
`agent_version`	string or null
`agent_build_id`	string or null
`skill_ids`	array of string
`environment`	string or null
`resource` required	string
`action` required	string
`effect_occurred` required	string
`effect_result` required	string

Smallest valid example

{
  "envelope_id": "envelope-id",
  "tool_id": "tool-id",
  "resource": "resource",
  "action": "action",
  "effect_occurred": "effect-occurred",
  "effect_result": "effect-result"
}

JSON Schema

Show the raw definition

{
  "properties": {
    "envelope_id": {
      "type": "string",
      "title": "Envelope Id"
    },
    "tool_id": {
      "type": "string",
      "title": "Tool Id"
    },
    "tool_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tool Version"
    },
    "mcp_server_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mcp Server Id"
    },
    "mcp_server_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mcp Server Version"
    },
    "model_provider": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Model Provider"
    },
    "model_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Model Name"
    },
    "model_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Model Version"
    },
    "agent_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent Version"
    },
    "agent_build_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agent Build Id"
    },
    "skill_ids": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Skill Ids"
    },
    "environment": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Environment"
    },
    "resource": {
      "type": "string",
      "title": "Resource"
    },
    "action": {
      "type": "string",
      "title": "Action"
    },
    "effect_occurred": {
      "type": "string",
      "title": "Effect Occurred"
    },
    "effect_result": {
      "type": "string",
      "title": "Effect Result"
    }
  },
  "type": "object",
  "required": [
    "envelope_id",
    "tool_id",
    "resource",
    "action",
    "effect_occurred",
    "effect_result"
  ],
  "title": "RecordProvenanceRequest"
}

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