Tools
Overview
The eight tools noiz gives an AI app, with their permissions and safety hints.
These are the tools noiz offers an AI app, read straight from the server. An app is offered only the tools its permissions cover, and none of them takes an account, page or username: each one works on the signed-in account's own page.
See your page: your name, bio, location and links
| Tool | What it does | Kind |
|---|---|---|
get_my_page | Read my noiz page | Read only |
See your page's views and clicks
| Tool | What it does | Kind |
|---|---|---|
get_analytics | Read my page's views and clicks | Read only |
Change your links, name, bio and location
| Tool | What it does | Kind |
|---|---|---|
add_link | Add a link | Only adds |
update_link | Change a link | Replaces something on the page |
archive_link | Take a link off the page | Replaces something on the page |
reorder_links | Reorder links | Replaces something on the page |
set_featured_link | Feature a link | Replaces something on the page |
update_profile_text | Change my name, bio or location | Replaces something on the page |
Safety hints
Every tool carries a title and three hints that apps use to decide when to ask you before a call. Noiz states all three on every tool and errs on the side of asking:
| Hint | Meaning on noiz |
|---|---|
readOnlyHint | True for the two tools that only read. Everything else changes your page. |
destructiveHint | True for every edit that replaces something already there, archiving included, even though nothing is deleted and the dashboard can undo it. Only adding a link is not. |
openWorldHint | True for every edit: it changes your public page, which anyone on the web can see. The reads return only your own data. |
idempotentHint | True where repeating the same call leaves the page the same, such as setting a title. Adding a link twice adds two links. |