Skip to main content
The server advertises its full tool list on connect, so you rarely need to name tools yourself — the model picks them. This page is a reference for what’s available and how access is gated. Tool names and schemas may evolve; the live tools/list from your connection is always authoritative.
Every tool runs as your API key, in its workspace. A tool the key lacks permission for is refused — see Permissions.

​
Workflows

Build, version, and run flows.
  • Manage — workflows_list, workflows_get, workflows_update, workflows_delete, workflows_list_versions, workflows_save_version
  • Run — workflows_run, workflows_run_partial, workflows_list_runs
  • Author (node graph) — workflows_build, workflows_get_state, workflows_edit_nodes, workflows_add_node, workflows_link_nodes, workflows_remove_node, workflows_validate, workflows_autolayout, workflows_create_trigger, workflows_list_variables
  • Node catalog — workflows_get_node_schemas, workflows_search_nodes, workflows_get_node_outputs

​
Runs

Inspect executions.
  • runs_list, runs_get, runs_get_status, runs_wait, runs_inspect, runs_get_node

​
Agents (co-workers)

  • agents_list, agents_get, agents_create, agents_update, agents_delete
  • agents_list_triggers, agents_add_trigger

​
Conversations

Chat with an agent and read history.
  • conversations_list, conversations_get, conversations_create, conversations_update, conversations_delete
  • conversations_chat, conversations_get_messages, conversations_inspect_messages

​
Knowledge bases

Manage KBs and their documents, and retrieve from them.
  • Manage — knowledge_bases_list, knowledge_bases_get, knowledge_bases_create, knowledge_bases_delete
  • Documents — knowledge_bases_upload_documents, knowledge_bases_list_documents, knowledge_bases_get_document, knowledge_bases_delete_document, knowledge_bases_export_documents, knowledge_bases_get_runs, knowledge_bases_get_tree, knowledge_bases_list_folder
  • Search — knowledge_bases_search, knowledge_bases_search_documents

​
Data tables

Structured rows + read-only SQL.
  • Schema — tables_list, tables_get_schema, tables_create, tables_add_column
  • Rows — tables_get_rows, tables_insert_rows, tables_update_rows, tables_delete_rows
  • Query — tables_query (read-only SQL across the workspace’s tables)

​
Sandboxes

Ephemeral code-execution environments.
  • sandboxes_create, sandboxes_list, sandboxes_get, sandboxes_delete
  • sandboxes_run_command, sandboxes_write_file, sandboxes_read_file

​
Deployments (channels)

Publish an agent to a channel.
  • deployments_list_channels, deployments_list, deployments_get, deployments_create, deployments_activate, deployments_deactivate, deployments_delete

​
Files

  • files_upload, files_download

​
Workspaces & admin

  • workspaces_list
  • admin_get_me, admin_list_workspaces, admin_create_workspace

​
Documentation

Let the model look things up in the Noxus docs.
  • documentation_list_sections, documentation_read, documentation_search

​
Permissions

Tools are gated by the permissions of the API key you connected with — identical to the REST API. A few consequences worth knowing:
  • A read-only key can list/read/search but can’t create, edit, or delete.
  • Running code in a sandbox requires the sandboxes:run permission (it is never implied by general resource access).
  • Tenant-wide actions (creating workspaces, managing users) require a system API key — an ordinary workspace key can’t perform them.
If a tool is refused, the connected key is missing that permission — mint a key with the needed scope, or use a key from a workspace where you have the role. See Authentication.