Skip to main content

ToolMutations

No description

type ToolMutations {
createTool(
name: String!
description: String!
access: String!
): ToolData
updateTool(
toolId: Long!
name: String!
description: String!
inputSchema: String!
outputSelection: String
access: String!
enabled: Boolean!
): ToolData
deleteTool(
toolId: Long!
): Boolean
}

Fields

ToolMutations.createTool ● ToolData object

Create an Agent tool AND its kind='tool' process with a seeded draft workflow

ToolMutations.createTool.name ● String! non-null scalar

Function name the model calls: ^[a-z][a-z0-9_]*$, unique per org

ToolMutations.createTool.description ● String! non-null scalar
ToolMutations.createTool.access ● String! non-null scalar

read_only | mutating

ToolMutations.updateTool ● ToolData object

Update the tool contract (schema, output selection, access, enabled)

ToolMutations.updateTool.toolId ● Long! non-null scalar
ToolMutations.updateTool.name ● String! non-null scalar
ToolMutations.updateTool.description ● String! non-null scalar
ToolMutations.updateTool.inputSchema ● String! non-null scalar

Input JSON Schema (supported subset; validated on save and on every dispatch)

ToolMutations.updateTool.outputSelection ● String scalar

ToolOutputSelection JSON; omitted = the terminal node's output

ToolMutations.updateTool.access ● String! non-null scalar
ToolMutations.updateTool.enabled ● Boolean! non-null scalar

ToolMutations.deleteTool ● Boolean scalar

Delete a tool and its process; blocked while agents still reference it

ToolMutations.deleteTool.toolId ● Long! non-null scalar

Returned By

tools mutation