NOIZDocs
DashboardGet started

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

ToolWhat it doesKind
get_my_pageRead my noiz pageRead only

See your page's views and clicks

ToolWhat it doesKind
get_analyticsRead my page's views and clicksRead only

Change your links, name, bio and location

ToolWhat it doesKind
add_linkAdd a linkOnly adds
update_linkChange a linkReplaces something on the page
archive_linkTake a link off the pageReplaces something on the page
reorder_linksReorder linksReplaces something on the page
set_featured_linkFeature a linkReplaces something on the page
update_profile_textChange my name, bio or locationReplaces 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:

HintMeaning on noiz
readOnlyHintTrue for the two tools that only read. Everything else changes your page.
destructiveHintTrue 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.
openWorldHintTrue for every edit: it changes your public page, which anyone on the web can see. The reads return only your own data.
idempotentHintTrue where repeating the same call leaves the page the same, such as setting a title. Adding a link twice adds two links.