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
  setToolBarryEnabled(
    toolId: Long!
    barryEnabled: Boolean!
  ): ToolData
}

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​

ToolMutations.setToolBarryEnabled ● ToolData object​

Release the tool to the Barry AI copilot, or withdraw it: a read-only tool then runs directly from a home chat as a real run of its process, a mutating one only behind an approval card the member answers. Off by default; enabling requires a released workflow. Requires canManageAgents permission

ToolMutations.setToolBarryEnabled.toolId ● Long! non-null scalar​
ToolMutations.setToolBarryEnabled.barryEnabled ● Boolean! non-null scalar​

Returned By​

tools mutation