CAIN-42 CAIN Studio

API reference · schema

FastPathGrantRequest

3 fields · used by 1 operations

Last reviewed 2026-10-02

Fields

FieldTypeMeaning
tools requiredarray of stringPaths the agent calls, e.g. /tools/read_file. A trailing / covers that subtree. No wildcards.
min items 1 · max items 64
servicestring or nullLeave empty for your own tools (calls that name no service).
max length 256
ttl_sintegerSnapshot lifetime; the cluster re-commits it at half-life while the grant lasts.
min 5.0 · max 900.0 · default 120

Smallest valid example

{
  "tools": [
    "tools"
  ],
  "ttl_s": 120
}

Used by 1 operation

POST/fabric/agent-keys/{agent_key_id}/fast-pathLet one agent's already-allowed calls to these tools skip the per-call consensus round

JSON Schema

Show the raw definition
{
  "properties": {
    "tools": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "maxItems": 64,
      "minItems": 1,
      "title": "Tools",
      "description": "Paths the agent calls, e.g. /tools/read_file. A trailing / covers that subtree. No wildcards."
    },
    "service": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 256
        },
        {
          "type": "null"
        }
      ],
      "title": "Service",
      "description": "Leave empty for your own tools (calls that name no service)."
    },
    "ttl_s": {
      "type": "integer",
      "maximum": 900.0,
      "minimum": 5.0,
      "title": "Ttl S",
      "description": "Snapshot lifetime; the cluster re-commits it at half-life while the grant lasts.",
      "default": 120
    }
  },
  "type": "object",
  "required": [
    "tools"
  ],
  "title": "FastPathGrantRequest"
}

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