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
  • agents_search_capabilities, agents_get_capability_settings: an agent is built from capabilities, and every one of its settings belongs to one. Search them by what they do, then read one capability’s versions, changelog and settings, with the values each option takes.
  • agents_pin_capabilities: move an agent onto a capability version, the same as the agent’s Capability versions dialog. An opt-in capability such as tool output overflow is off until pinned, and its quick action cannot be switched on with agents_update before then.

​
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_update (name / description), knowledge_bases_delete
  • Documents — knowledge_bases_upload_documents, knowledge_bases_add_website, knowledge_bases_list_documents, knowledge_bases_get_document, knowledge_bases_delete_documents (by path), knowledge_bases_retry_documents, knowledge_bases_export_documents, knowledge_bases_get_runs, knowledge_bases_get_tree, knowledge_bases_list_folder
  • Syncs — knowledge_bases_list_syncs, knowledge_bases_run_sync
  • Search — knowledge_bases_search, knowledge_bases_search_documents

​
Tables

Structured rows and SQL. See Tables.
  • Schema — tables_list, tables_get_schema, tables_create, tables_update (name / description; the SQL identifier never changes, platform tables are refused), tables_add_column, tables_update_column (rename or change type), tables_drop_column, tables_delete
  • Rows — tables_get_rows, tables_insert_rows, tables_update_rows, tables_duplicate_rows, tables_delete_rows (update, duplicate and delete target rows by id), tables_clear_rows (every row, columns kept)
  • Query — tables_query (read-only SQL across the workspace’s tables), tables_run_statement (one INSERT or UPDATE; prefer the row tools, which bind values safely)
  • Import and export: tables_preview_csv (dry run), tables_import_csv (an attached CSV into a new or existing table), tables_export (a table, a filtered view or a query result as CSV)
tables_check_add_column, tables_check_update_column, tables_check_run_statement and tables_check_import_csv check whether a change would succeed without making it.

​
Sandboxes

Each agent’s own sandbox, addressed by agent_id, and sandboxes of the workspace’s own, addressed by sandbox_id and their label.
  • sandboxes_list, sandboxes_create, sandboxes_delete, sandboxes_reset (an agent’s sandbox)
  • sandboxes_run_command, sandboxes_write_file, sandboxes_read_file, sandboxes_list_files

​
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.