Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt

Use this file to discover all available pages before exploring further.

The Hudu API tool gives Neo agents direct access to the Hudu REST API — read, create, update, and delete Hudu resources during ticket resolution.
Automatically enabled when you configure Hudu permissions in your agent workflow. No manual toggle needed. See the Hudu integration page for the full permission model.

What It Does

  • Look up companies, articles, assets, and procedures
  • Create and update knowledge base articles based on ticket resolutions
  • Manage asset records and their structured fields
  • Browse asset layouts (schemas) and documentation folders
  • Read and manage network infrastructure documentation — networks, VLANs, IPAM, racks
  • Retrieve passwords (with technician approval)
  • Access any Hudu API endpoint with permission-group-based access control

Permission Groups

Permission GroupWhat It Covers
CompaniesCompanies, relations, activity logs, matchers, integration cards
ArticlesKnowledge base articles, procedures, uploads, public photos
AssetsAsset records — structured data entries created from asset layouts
Asset LayoutsAsset layout definitions — the schemas that define asset structure
PasswordsAsset passwords and password folders
FoldersDocumentation folders for organizing articles
InfrastructureNetworks, VLANs, VLAN zones, IP addresses (IPAM), rack storages
WebsitesMonitored website entries — uptime and SSL tracking
Each group has an access level: Disabled, Read Only, or Read/Write.

Access Profiles

All groups Read Only. Agent can look up any resource but cannot modify.
Articles, Assets, Folders, and Websites at Read/Write. Everything else Read Only.
All groups Read/Write with delete enabled. Password writes still require technician approval; company deletion is always blocked.

Safety Controls

ControlBehavior
Technician-in-the-LoopRequire human approval for writes — configurable per group
Password protectionAll password writes always require approval, regardless of settings
Company safetyAgents can never delete companies
Delete controlDelete permissions off by default, must be explicitly enabled per group

How to Configure

1

Connect Hudu

Connect your Hudu instance with an API key in the Neo Dashboard.
2

Configure permissions

In your agent workflow’s Integrations tab, choose an access profile or customize each permission group.
3

Set approval requirements

Decide which permission groups require technician approval for writes.
Start with Read Only and gradually expand. Enable Technician-in-the-Loop for writes until you’re confident in the agent’s behavior.