API reference · schema

ToolParamSpec

5 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

Field	Type	Meaning
`name` required	string	max length `128`
`type`	string	default `"string"`
`required`	boolean	default `true`
`format`	string or null
`grounded_in`	string or null

Smallest valid example

{
  "name": "name",
  "type": "string",
  "required": true
}

Used by 1 operation

PUT /fabric/toolargs/schemas Register or replace a tool schema (operator-admin)

JSON Schema

Show the raw definition

{
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 128,
      "title": "Name"
    },
    "type": {
      "type": "string",
      "title": "Type",
      "default": "string"
    },
    "required": {
      "type": "boolean",
      "title": "Required",
      "default": true
    },
    "format": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Format"
    },
    "grounded_in": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Grounded In"
    }
  },
  "type": "object",
  "required": [
    "name"
  ],
  "title": "ToolParamSpec"
}

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