The CloudRadial AutomationAI Hudu extension lets a workflow or agent work with your Hudu IT documentation: look up companies and assets, read knowledge-base articles, procedures, websites, relations, and upcoming expirations, and, with approval, create or update assets, articles, and websites or reveal a stored password. This article covers what the extension can do, the API key and secrets it needs, which tools require approval, how it handles passwords, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the API Key
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- How the Extension Handles Passwords
- Skills
- Tips for Working With Hudu Data
What the Extension Covers
The extension calls the Hudu REST API and provides 20 tools across these areas:
| Area | What you can automate |
| Companies | List companies, filtered by name, city, state, or the company's id in your PSA, and read one company |
| Assets and asset layouts | List assets by company, layout, name, serial number, or archived state, read one asset, create or update an asset, and list or read the asset layouts that define an asset's fields |
| Knowledge-base articles | List and read articles, and create or update an article for one company or for your global knowledge base |
| Passwords | List password records (name, company, and username only) and read one record, including its stored password |
| Websites | List monitored websites (domains), and add a website to a company or update one |
| Procedures, relations, and expirations | List procedures (runbooks), list the relations between objects such as assets, articles, and websites, and list upcoming SSL certificate, domain, warranty, asset field, and article expirations. Read-only. |
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating the API Key
The extension signs in to Hudu with an API key, sent on every request. In Hudu, go to Admin > API > API Keys and generate a key. Treat it as a full-access credential.
Providing the Credentials to Your Runner
Store two secrets in your runner's Key Vault with these exact names:
| Secret | Value |
Hudu-ApiUrl |
The base URL of your Hudu instance, self-hosted or cloud, for example https://yourname.huducloud.com. Do not add /api/v1; the extension adds the API path itself. |
Hudu-ApiKey |
The API key you generated in Hudu |
For how to add secrets, see Accessing and updating your runner's Key Vault.
Reads and Approval-Gated Changes
Of the 20 tools, 13 run without approval. The other seven pause the run for approval: the six tools that create or update records, and the one read tool that reveals a stored password. The request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated changes | Create or update an asset; create or update an article; create or update a website |
| Approval-gated read | Read one password record, which returns the stored password |
| Read-only | List and read companies; list and read assets; list and read asset layouts; list and read articles; list password records; list websites; list procedures; list relations; list expirations |
How the Extension Handles Passwords
The password tools are read-only. The extension cannot create, change, or delete a password record.
- Listing password records returns metadata only, such as the name, company, and username, not the stored password. It runs without approval, but its output is still sensitive.
- Reading a single password record returns the stored password, so it always asks for approval first. Agents are instructed to treat the output as highly sensitive and not to repeat the password unless you explicitly ask for it.
Approve a password read only when the run needs that credential.
Skills
The extension ships six skills that guide an agent through common Hudu tasks:
| Skill | Use it to |
| Look Up Companies and Assets | Find a company or asset, read its details, or find the ids other steps need. Read-only. |
| Manage Documented Assets | Create or update a documented asset. The agent finds the company and asset layout first. Writes are approval-gated. |
| Manage Knowledge-Base Articles | Find, read, write, or update a knowledge-base article. Writes are approval-gated. |
| Retrieve Passwords and Websites | Look up a stored credential or a monitored website, or browse object relations. Output may include secrets, and reading a single password is approval-gated. |
| Manage Websites | Add a website to a company, change an existing website, or sync domains into Hudu from another system. Writes are approval-gated. |
| Review Expirations and Procedures | Review upcoming SSL certificate, domain, warranty, asset field, and article expirations, or find documented procedures. Read-only. |
To give an agent these skills, see Creating custom agents and using them in workflows.
Tips for Working With Hudu Data
- Refer to companies by name and let the agent look up the id. To find the Hudu company linked to a PSA company, give the PSA company id, for example an Autotask company id.
- Creating an asset needs both a company and an asset layout. The agent looks up both first rather than guessing ids.
- When you update an asset, article, or website, give only the fields you want to change
- An article created without a company goes to your global knowledge base. Name the company to scope it to one client.
- Before adding a website, the agent compares the domain against that company's existing websites, ignoring the scheme, a leading
www., any path, and letter case, so it doesn't create a duplicate - List tools return the complete set in one call, so you do not need to page through results
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.