Skill MCP tools

Use this reference to find a tool and its inputs. Connect an MCP client before calling tools. Tool visibility depends on discovery and permissions.

For actions that send messages, spend credits, delete data, or start execution, review the intended records and confirm the action before proceeding. Obtain IDs from a prior result; do not invent them. A registered tool does not guarantee that its supporting service is available in every organization.

g8_skill_create_api

Create an API-runtime skill. Persists a new skill in the org; call with dry_run=True first to confirm, then dry_run=False. Args: name: Display name. endpoint: Full URL. May contain {variable} path placeholders (e.g. https://api.x.com/v1/{id}). method: HTTP method (default "POST"). One of GET\|POST\|PUT\|PATCH\|DELETE. description: Optional human-readable summary. category: Optional grouping. object_type: Optional entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". headers: Static request headers. Values may use {var}. body_template: Request body template; {var} substituted at runtime. query_params: Static query params dict. Values may use {var}. body_type: json, form-urlencoded, form-data, raw, or graphql. Defaults to json. content_type: Custom Content-Type header. Auto-detected from body_type if omitted. requires_approval: Force manual approval before execution. dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
name	Yes	string	See the schema below for constraints and defaults.
endpoint	Yes	string	See the schema below for constraints and defaults.
method	No	string	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
headers	No	object / null	See the schema below for constraints and defaults.
body_template	No	string / null	See the schema below for constraints and defaults.
query_params	No	object / null	See the schema below for constraints and defaults.
body_type	No	string / null	See the schema below for constraints and defaults.
content_type	No	string / null	See the schema below for constraints and defaults.
requires_approval	No	boolean	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "endpoint": {
      "title": "Endpoint",
      "type": "string"
    },
    "method": {
      "default": "POST",
      "title": "Method",
      "type": "string"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "body_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Template"
    },
    "query_params": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query Params"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Type"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Type"
    },
    "requires_approval": {
      "default": false,
      "title": "Requires Approval",
      "type": "boolean"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "name",
    "endpoint"
  ],
  "title": "create_api_skillArguments",
  "type": "object"
}

g8_skill_create_from_node

Lift a workflow action node into a standalone skill (a copy; the workflow is NOT modified). Persists a new skill; confirm with dry_run=True before calling with dry_run=False. To make the node reference the new skill, update it afterward with g8_workflow_update_node to set config.action_id. Args: workflow_id: Workflow UUID. node_id: Node id inside the workflow’s graph. name: Optional new name; defaults to "<source name> (Copy)". dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
workflow_id	Yes	string	See the schema below for constraints and defaults.
node_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "workflow_id": {
      "title": "Workflow Id",
      "type": "string"
    },
    "node_id": {
      "title": "Node Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "workflow_id",
    "node_id"
  ],
  "title": "create_from_nodeArguments",
  "type": "object"
}

g8_skill_create_from_template

Clone a skill template into the org. Persists a new skill; confirm with dry_run=True before calling with dry_run=False. Only llm/api templates can be cloned (workflow/script runtimes are refused). Args: template_id: Template UUID from g8_skill_list_templates. name: Display name for the new skill. overrides: Optional dict of fields to override on the clone. dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
template_id	Yes	string	See the schema below for constraints and defaults.
name	Yes	string	See the schema below for constraints and defaults.
overrides	No	object / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "template_id": {
      "title": "Template Id",
      "type": "string"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "overrides": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Overrides"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "template_id",
    "name"
  ],
  "title": "create_from_templateArguments",
  "type": "object"
}

g8_skill_create_llm

Create an LLM-runtime skill. Persists a new skill in the org; call with dry_run=True first to render a confirmation preview, then again with dry_run=False after the user confirms. Args: name: Display name. model: Model id from g8_skill_list_models (e.g. "gpt-4o"). prompt_template: Prompt template. Use {variable} for inputs; they become the skill’s input surface (see g8_skill_extract_variables). description: Optional human-readable summary. category: Optional grouping (e.g. "Research", "Sales"). object_type: Optional entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". None (default) is global. temperature: LLM temperature (default 0.7). max_tokens: Max output tokens (default 1000). requires_approval: Force manual approval before execution (default False). dry_run: When True, return a confirmation preview instead of persisting.

Inputs

Input	Required	Type	Description
name	Yes	string	See the schema below for constraints and defaults.
model	Yes	string	See the schema below for constraints and defaults.
prompt_template	Yes	string	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
temperature	No	number	See the schema below for constraints and defaults.
max_tokens	No	integer	See the schema below for constraints and defaults.
requires_approval	No	boolean	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "prompt_template": {
      "title": "Prompt Template",
      "type": "string"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "temperature": {
      "default": 0.7,
      "title": "Temperature",
      "type": "number"
    },
    "max_tokens": {
      "default": 1000,
      "title": "Max Tokens",
      "type": "integer"
    },
    "requires_approval": {
      "default": false,
      "title": "Requires Approval",
      "type": "boolean"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "name",
    "model",
    "prompt_template"
  ],
  "title": "create_llm_skillArguments",
  "type": "object"
}

g8_skill_delete

Delete a skill (with reference check). Scans every workflow in the org; if ANY node references the skill the delete is refused and the offending workflows are listed, otherwise it hard-deletes. IMPORTANT: hard-delete is final - there is no restore. Call with dry_run=True to see the reference report + confirmation, then again with dry_run=False once the user confirms. Args: action_id: Skill UUID. dry_run: When True, return a confirmation preview (including any reference list) instead of deleting.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "delete_skillArguments",
  "type": "object"
}

g8_skill_execute

Run a skill once and return the execution result. Triggers a real execution (LLM call or HTTP request) and may consume credits; confirm with dry_run=True before calling with dry_run=False. input_data keys should match the {variable} placeholders from g8_skill_extract_variables; other keys pass through but won’t substitute. Args: action_id: Skill UUID. input_data: Dict of input field values for placeholder substitution (e.g. {"company_name": "Acme"}). dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
input_data	No	object / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "input_data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input Data"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "execute_skillArguments",
  "type": "object"
}

g8_skill_extract_variables

Extract single-brace {variable} placeholders from a skill’s templates (deduplicated, first-seen order). Double-brace {{var}} is ignored. LLM skills scan prompt_template; API skills scan endpoint, body_template, header values, and query param values. Use BEFORE wiring the skill into a workflow Action node so you know which input mappings to declare upstream. Args: action_id: Skill UUID.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "extract_variablesArguments",
  "type": "object"
}

g8_skill_get

Get a skill’s full configuration (metadata + llm_config or api_config). Returns 404 if the action_id is a workflow or script; use g8_workflow_get for workflow rows. Args: action_id: Skill UUID.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "get_skillArguments",
  "type": "object"
}

g8_skill_list

List skills (LLM + API runtimes) owned by the caller’s org. Workflows (use g8_workflow_list) and script-runtime actions are not shown. Args: runtime_type: Filter to "llm" or "api". Omit to see both. enabled: Filter by enabled flag. category: Filter by free-text category (e.g. "Sales"). object_type: Filter by entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". Omit for global. include_system: When True (default), merge in shared system-default skills alongside org-owned ones.

Inputs

Input	Required	Type	Description
runtime_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
include_system	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "runtime_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Runtime Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "include_system": {
      "default": true,
      "title": "Include System",
      "type": "boolean"
    }
  },
  "title": "list_skillsArguments",
  "type": "object"
}

g8_skill_list_models

List supported LLM model identifiers for the model field of g8_skill_create_llm / g8_skill_update_llm. Returns {models: [{id, provider, label}], total: N}. Curated list; the create/update endpoints accept any string.

Inputs

Input	Required	Type	Description
None	No	—	No user-supplied inputs.

Complete input schema

{
  "properties": {},
  "title": "list_modelsArguments",
  "type": "object"
}

g8_skill_list_templates

List skill templates available in the caller’s org (plus shared system templates). Workflow templates are excluded. Pass the returned action_id to g8_skill_create_from_template to clone one. Args: category: Optional category filter.

Inputs

Input	Required	Type	Description
category	No	string / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    }
  },
  "title": "list_templatesArguments",
  "type": "object"
}

g8_skill_update_api

Update an API-runtime skill. Pass only the fields you want to change. Returns 404 if the action is not an API skill (runtime cannot switch). Args: action_id: Skill UUID. name, description, category, object_type, enabled: Top-level metadata. endpoint, method, headers, body_template, query_params, body_type, content_type: API config. If ANY one is passed, all are sent (update replaces the full api_config block), so fetch current values via g8_skill_get first for a partial change. requires_approval: Approval gate toggle.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
endpoint	No	string / null	See the schema below for constraints and defaults.
method	No	string / null	See the schema below for constraints and defaults.
headers	No	object / null	See the schema below for constraints and defaults.
body_template	No	string / null	See the schema below for constraints and defaults.
query_params	No	object / null	See the schema below for constraints and defaults.
body_type	No	string / null	See the schema below for constraints and defaults.
content_type	No	string / null	See the schema below for constraints and defaults.
requires_approval	No	boolean / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "endpoint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Endpoint"
    },
    "method": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Method"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "body_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Template"
    },
    "query_params": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query Params"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Type"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Type"
    },
    "requires_approval": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Requires Approval"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "update_api_skillArguments",
  "type": "object"
}

g8_skill_update_llm

Update an LLM-runtime skill. Pass only the fields you want to change. Returns 404 if the action is not an LLM skill (runtime cannot switch). Args: action_id: Skill UUID. name, description, category, object_type, enabled: Top-level metadata. model, prompt_template, temperature, max_tokens: LLM config. If ANY one is passed, all four are sent (update replaces the full llm_config block), so fetch current values via g8_skill_get first for a partial change. requires_approval: Approval gate toggle.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
model	No	string / null	See the schema below for constraints and defaults.
prompt_template	No	string / null	See the schema below for constraints and defaults.
temperature	No	number / null	See the schema below for constraints and defaults.
max_tokens	No	integer / null	See the schema below for constraints and defaults.
requires_approval	No	boolean / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Model"
    },
    "prompt_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Prompt Template"
    },
    "temperature": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Temperature"
    },
    "max_tokens": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Tokens"
    },
    "requires_approval": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Requires Approval"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "update_llm_skillArguments",
  "type": "object"
}

g8_skill_validate_template

Dry-run a skill template through the variable extractor and warn-only validator. Two call shapes: pass a single template string, OR pass runtime_type + a matching llm_config/api_config to scan every template field the runtime would use. Warn-only: valid is always True for parseable templates; warnings list soft issues (double-brace usage, unmatched braces) to repair before saving. Args: template: Single template string. runtime_type: "llm" or "api" (when passing a full skill shape). llm_config: Full LLM config dict. api_config: Full API config dict.

Inputs

Input	Required	Type	Description
template	No	string / null	See the schema below for constraints and defaults.
runtime_type	No	string / null	See the schema below for constraints and defaults.
llm_config	No	object / null	See the schema below for constraints and defaults.
api_config	No	object / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Template"
    },
    "runtime_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Runtime Type"
    },
    "llm_config": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Llm Config"
    },
    "api_config": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Config"
    }
  },
  "title": "validate_templateArguments",
  "type": "object"
}

g8_workflow_skill_create_api

Create an API-runtime skill. Persists a new skill in the org; call with dry_run=True first to confirm, then dry_run=False. Args: name: Display name. endpoint: Full URL. May contain {variable} path placeholders (e.g. https://api.x.com/v1/{id}). method: HTTP method (default "POST"). One of GET\|POST\|PUT\|PATCH\|DELETE. description: Optional human-readable summary. category: Optional grouping. object_type: Optional entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". headers: Static request headers. Values may use {var}. body_template: Request body template; {var} substituted at runtime. query_params: Static query params dict. Values may use {var}. body_type: json, form-urlencoded, form-data, raw, or graphql. Defaults to json. content_type: Custom Content-Type header. Auto-detected from body_type if omitted. requires_approval: Force manual approval before execution. dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
name	Yes	string	See the schema below for constraints and defaults.
endpoint	Yes	string	See the schema below for constraints and defaults.
method	No	string	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
headers	No	object / null	See the schema below for constraints and defaults.
body_template	No	string / null	See the schema below for constraints and defaults.
query_params	No	object / null	See the schema below for constraints and defaults.
body_type	No	string / null	See the schema below for constraints and defaults.
content_type	No	string / null	See the schema below for constraints and defaults.
requires_approval	No	boolean	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "endpoint": {
      "title": "Endpoint",
      "type": "string"
    },
    "method": {
      "default": "POST",
      "title": "Method",
      "type": "string"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "body_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Template"
    },
    "query_params": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query Params"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Type"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Type"
    },
    "requires_approval": {
      "default": false,
      "title": "Requires Approval",
      "type": "boolean"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "name",
    "endpoint"
  ],
  "title": "create_api_skillArguments",
  "type": "object"
}

g8_workflow_skill_create_from_node

Lift a workflow action node into a standalone skill (a copy; the workflow is NOT modified). Persists a new skill; confirm with dry_run=True before calling with dry_run=False. To make the node reference the new skill, update it afterward with g8_workflow_update_node to set config.action_id. Args: workflow_id: Workflow UUID. node_id: Node id inside the workflow’s graph. name: Optional new name; defaults to "<source name> (Copy)". dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
workflow_id	Yes	string	See the schema below for constraints and defaults.
node_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "workflow_id": {
      "title": "Workflow Id",
      "type": "string"
    },
    "node_id": {
      "title": "Node Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "workflow_id",
    "node_id"
  ],
  "title": "create_from_nodeArguments",
  "type": "object"
}

g8_workflow_skill_create_from_template

Clone a skill template into the org. Persists a new skill; confirm with dry_run=True before calling with dry_run=False. Only llm/api templates can be cloned (workflow/script runtimes are refused). Args: template_id: Template UUID from g8_skill_list_templates. name: Display name for the new skill. overrides: Optional dict of fields to override on the clone. dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
template_id	Yes	string	See the schema below for constraints and defaults.
name	Yes	string	See the schema below for constraints and defaults.
overrides	No	object / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "template_id": {
      "title": "Template Id",
      "type": "string"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "overrides": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Overrides"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "template_id",
    "name"
  ],
  "title": "create_from_templateArguments",
  "type": "object"
}

g8_workflow_skill_create_llm

Create an LLM-runtime skill. Persists a new skill in the org; call with dry_run=True first to render a confirmation preview, then again with dry_run=False after the user confirms. Args: name: Display name. model: Model id from g8_skill_list_models (e.g. "gpt-4o"). prompt_template: Prompt template. Use {variable} for inputs; they become the skill’s input surface (see g8_skill_extract_variables). description: Optional human-readable summary. category: Optional grouping (e.g. "Research", "Sales"). object_type: Optional entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". None (default) is global. temperature: LLM temperature (default 0.7). max_tokens: Max output tokens (default 1000). requires_approval: Force manual approval before execution (default False). dry_run: When True, return a confirmation preview instead of persisting.

Inputs

Input	Required	Type	Description
name	Yes	string	See the schema below for constraints and defaults.
model	Yes	string	See the schema below for constraints and defaults.
prompt_template	Yes	string	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
temperature	No	number	See the schema below for constraints and defaults.
max_tokens	No	integer	See the schema below for constraints and defaults.
requires_approval	No	boolean	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "model": {
      "title": "Model",
      "type": "string"
    },
    "prompt_template": {
      "title": "Prompt Template",
      "type": "string"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "temperature": {
      "default": 0.7,
      "title": "Temperature",
      "type": "number"
    },
    "max_tokens": {
      "default": 1000,
      "title": "Max Tokens",
      "type": "integer"
    },
    "requires_approval": {
      "default": false,
      "title": "Requires Approval",
      "type": "boolean"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "name",
    "model",
    "prompt_template"
  ],
  "title": "create_llm_skillArguments",
  "type": "object"
}

g8_workflow_skill_delete

Delete a skill (with reference check). Scans every workflow in the org; if ANY node references the skill the delete is refused and the offending workflows are listed, otherwise it hard-deletes. IMPORTANT: hard-delete is final - there is no restore. Call with dry_run=True to see the reference report + confirmation, then again with dry_run=False once the user confirms. Args: action_id: Skill UUID. dry_run: When True, return a confirmation preview (including any reference list) instead of deleting.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "delete_skillArguments",
  "type": "object"
}

g8_workflow_skill_execute

Run a skill once and return the execution result. Triggers a real execution (LLM call or HTTP request) and may consume credits; confirm with dry_run=True before calling with dry_run=False. input_data keys should match the {variable} placeholders from g8_skill_extract_variables; other keys pass through but won’t substitute. Args: action_id: Skill UUID. input_data: Dict of input field values for placeholder substitution (e.g. {"company_name": "Acme"}). dry_run: When True, return a confirmation preview.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
input_data	No	object / null	See the schema below for constraints and defaults.
dry_run	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "input_data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Input Data"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "execute_skillArguments",
  "type": "object"
}

g8_workflow_skill_extract_variables

Extract single-brace {variable} placeholders from a skill’s templates (deduplicated, first-seen order). Double-brace {{var}} is ignored. LLM skills scan prompt_template; API skills scan endpoint, body_template, header values, and query param values. Use BEFORE wiring the skill into a workflow Action node so you know which input mappings to declare upstream. Args: action_id: Skill UUID.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "extract_variablesArguments",
  "type": "object"
}

g8_workflow_skill_get

Get a skill’s full configuration (metadata + llm_config or api_config). Returns 404 if the action_id is a workflow or script; use g8_workflow_get for workflow rows. Args: action_id: Skill UUID.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "get_skillArguments",
  "type": "object"
}

g8_workflow_skill_list

List skills (LLM + API runtimes) owned by the caller’s org. Workflows (use g8_workflow_list) and script-runtime actions are not shown. Args: runtime_type: Filter to "llm" or "api". Omit to see both. enabled: Filter by enabled flag. category: Filter by free-text category (e.g. "Sales"). object_type: Filter by entity target - "Company"\|"Contact"\|"Deal"\|"Campaign". Omit for global. include_system: When True (default), merge in shared system-default skills alongside org-owned ones.

Inputs

Input	Required	Type	Description
runtime_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
include_system	No	boolean	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "runtime_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Runtime Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "include_system": {
      "default": true,
      "title": "Include System",
      "type": "boolean"
    }
  },
  "title": "list_skillsArguments",
  "type": "object"
}

g8_workflow_skill_list_models

List supported LLM model identifiers for the model field of g8_skill_create_llm / g8_skill_update_llm. Returns {models: [{id, provider, label}], total: N}. Curated list; the create/update endpoints accept any string.

Inputs

Input	Required	Type	Description
None	No	—	No user-supplied inputs.

Complete input schema

{
  "properties": {},
  "title": "list_modelsArguments",
  "type": "object"
}

g8_workflow_skill_list_templates

List skill templates available in the caller’s org (plus shared system templates). Workflow templates are excluded. Pass the returned action_id to g8_skill_create_from_template to clone one. Args: category: Optional category filter.

Inputs

Input	Required	Type	Description
category	No	string / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    }
  },
  "title": "list_templatesArguments",
  "type": "object"
}

g8_workflow_skill_update_api

Update an API-runtime skill. Pass only the fields you want to change. Returns 404 if the action is not an API skill (runtime cannot switch). Args: action_id: Skill UUID. name, description, category, object_type, enabled: Top-level metadata. endpoint, method, headers, body_template, query_params, body_type, content_type: API config. If ANY one is passed, all are sent (update replaces the full api_config block), so fetch current values via g8_skill_get first for a partial change. requires_approval: Approval gate toggle.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
endpoint	No	string / null	See the schema below for constraints and defaults.
method	No	string / null	See the schema below for constraints and defaults.
headers	No	object / null	See the schema below for constraints and defaults.
body_template	No	string / null	See the schema below for constraints and defaults.
query_params	No	object / null	See the schema below for constraints and defaults.
body_type	No	string / null	See the schema below for constraints and defaults.
content_type	No	string / null	See the schema below for constraints and defaults.
requires_approval	No	boolean / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "endpoint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Endpoint"
    },
    "method": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Method"
    },
    "headers": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Headers"
    },
    "body_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Template"
    },
    "query_params": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query Params"
    },
    "body_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Body Type"
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content Type"
    },
    "requires_approval": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Requires Approval"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "update_api_skillArguments",
  "type": "object"
}

g8_workflow_skill_update_llm

Update an LLM-runtime skill. Pass only the fields you want to change. Returns 404 if the action is not an LLM skill (runtime cannot switch). Args: action_id: Skill UUID. name, description, category, object_type, enabled: Top-level metadata. model, prompt_template, temperature, max_tokens: LLM config. If ANY one is passed, all four are sent (update replaces the full llm_config block), so fetch current values via g8_skill_get first for a partial change. requires_approval: Approval gate toggle.

Inputs

Input	Required	Type	Description
action_id	Yes	string	See the schema below for constraints and defaults.
name	No	string / null	See the schema below for constraints and defaults.
description	No	string / null	See the schema below for constraints and defaults.
category	No	string / null	See the schema below for constraints and defaults.
object_type	No	string / null	See the schema below for constraints and defaults.
enabled	No	boolean / null	See the schema below for constraints and defaults.
model	No	string / null	See the schema below for constraints and defaults.
prompt_template	No	string / null	See the schema below for constraints and defaults.
temperature	No	number / null	See the schema below for constraints and defaults.
max_tokens	No	integer / null	See the schema below for constraints and defaults.
requires_approval	No	boolean / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "action_id": {
      "title": "Action Id",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "object_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Object Type"
    },
    "enabled": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Enabled"
    },
    "model": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Model"
    },
    "prompt_template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Prompt Template"
    },
    "temperature": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Temperature"
    },
    "max_tokens": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Tokens"
    },
    "requires_approval": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Requires Approval"
    }
  },
  "required": [
    "action_id"
  ],
  "title": "update_llm_skillArguments",
  "type": "object"
}

g8_workflow_skill_validate_template

Dry-run a skill template through the variable extractor and warn-only validator. Two call shapes: pass a single template string, OR pass runtime_type + a matching llm_config/api_config to scan every template field the runtime would use. Warn-only: valid is always True for parseable templates; warnings list soft issues (double-brace usage, unmatched braces) to repair before saving. Args: template: Single template string. runtime_type: "llm" or "api" (when passing a full skill shape). llm_config: Full LLM config dict. api_config: Full API config dict.

Inputs

Input	Required	Type	Description
template	No	string / null	See the schema below for constraints and defaults.
runtime_type	No	string / null	See the schema below for constraints and defaults.
llm_config	No	object / null	See the schema below for constraints and defaults.
api_config	No	object / null	See the schema below for constraints and defaults.

Complete input schema

{
  "properties": {
    "template": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Template"
    },
    "runtime_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Runtime Type"
    },
    "llm_config": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Llm Config"
    },
    "api_config": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Config"
    }
  },
  "title": "validate_templateArguments",
  "type": "object"
}