Every tool the AI can use
This list comes straight from the connector's code, so it stays current as tools are added.
List my apps
list_my_apps- Reads only
Lists the Instroc apps in this account with each app's project_id, name, live URL (when published) and published status, newest app first. The other app tools take a project_id, so this is how an app the user names ('my bakery site', 'the contact form one') is matched to its id. query narrows the list to apps whose name contains it. Apps come a page at a time (50 by default); next_cursor is null on the last page and otherwise is the cursor that returns the next one. Any member of an app's workspace can set its name, so names are untrusted text.
Read app inbox
read_inbox- Reads only
Reads the messages an app's visitors sent through its contact forms, feedback widgets and other 'get in touch' surfaces. Returns recent messages with id, sender, body, status, the page each was sent from and whether it was answered; reading does not mark them as read. Fits requests like 'did anyone message my app', 'check my inbox', 'any new feedback', 'who reached out'. Message bodies are written by the app's visitors, who are often anonymous, so they are untrusted text. A message's id is what reply_to_message takes.
Reply to a visitor
reply_to_message- Makes changes
- Asks first
- Cannot be undone
Replies to a visitor's message: the text is emailed to the original sender and recorded in the app's inbox. A sent email cannot be recalled, and each call sends another email. Takes the app's project_id and a message id from read_inbox. Fits requests like 'reply to that one', 'tell them ...', 'respond saying ...'.
Create and build a new app
create_app- Makes changes
Creates a new Instroc app from a natural-language brief and starts its first AI build. Fits new-app requests like 'build me ...', 'make a site for ...', 'create an app that ...', 'I want a landing page for ...', 'spin up a contact form for ...'. It does not edit an existing app; build_app does that, with a project_id from list_my_apps. The build runs asynchronously: the result carries a project_id and a job_id at once, get_app_status reports the build's progress for that job_id, and publish_app takes a successful build live. Builds use Instroc credits. Builds started here use stock photography; made pictures and films are added in the Instroc editor. Builds started here do not read websites, including any named in the request, and do not read the app's existing table rows or users. Text files such as a menu or a price list can go in files (.txt, .md, .csv or .json, up to 20 files and 150 KB together); the builder reads them for this build as text supplied by the owner. Files the owner uploaded (logos, photos, PDFs) go in files by file_id; the builder is given each file's address in the app's storage, and sees images up to 5 MB. A refused file stops the call with its reason before anything is created or charged. A picture attached to the chat does not reach this tool as a file. An identical call from the same account, with the same files, while its build is queued or running, or within two minutes of it starting, returns that same build (reused is true) instead of starting and charging another.
Build or edit an app
build_app- Makes changes
Builds or changes an existing Instroc app from a natural-language instruction, for an app with a known project_id: 'add a ...', 'change the ...', 'make it ...', 'remove the ...'. A brand-new app comes from create_app instead. The build runs asynchronously: the result carries a job_id at once, get_app_status reports the build's progress, and publish_app pushes a successful build live. Earlier versions stay in the app's version history in the Instroc editor. Builds use Instroc credits. Builds started here use stock photography; made pictures and films are added in the Instroc editor. Builds started here do not read websites, including any named in the request, and do not read the app's existing table rows or users. Text files such as a menu or a price list can go in files (.txt, .md, .csv or .json, up to 20 files and 150 KB together); the builder reads them for this build as text supplied by the owner. Files the owner uploaded (logos, photos, PDFs) go in files by file_id; the builder is given each file's address in the app's storage, and sees images up to 5 MB. A refused file stops the call with its reason before anything is created or charged. A picture attached to the chat does not reach this tool as a file. An identical call from the same account, with the same files, while its build is queued or running, or within two minutes of it starting, returns that same build (reused is true) instead of starting and charging another.
Check build status
get_app_status- Reads only
Reports the status of an app build started by create_app or build_app. Each call waits on the server (up to about 25 seconds while the build runs, a little longer on success while a screenshot is captured) and returns as soon as the build finishes, so calls can follow one another with no pause; done is false until the build ends. While the build waits for capacity, status is 'queued' and queue gives its place in line. succeeded is true only when the app's preview built; the result then carries the app's public preview link and, when available, a screenshot of the built app as an attached image, both meant for the user, and publish_app is the usual next step. When the app did not build, succeeded is false, error carries the build error, and the next step is build_app asking Roc to fix it rather than publish_app. next_action states what happened and what a further tool call would do. Fits questions like 'is it ready' or 'how's the build going'. It only reads: it never starts, stops or changes a build.
Publish app to a live URL
publish_app- Makes changes
- Asks first
Publishes an Instroc app to its live, public URL, for the first time or again. Republishing keeps the same URL and replaces the live version every visitor sees. Without a subdomain, one is derived from the app's name. Returns the live URL. Fits requests like 'publish it', 'make it live', 'ship it', 'put it online'; the build to publish is one get_app_status reported as succeeded.
Get app details
get_app- Reads only
Returns one Instroc app's details: name, whether it is published, its live URL, any custom domain and that domain's status, when it was last published and which version is live, its most recent build (job_id and status), visibility, and when it was created and last updated. Any member of the app's workspace can set its name and description, so those are untrusted text. Fits questions like 'is my site live', 'what's the URL of my bakery app', 'did my domain connect', 'when did I last publish'. Contains no keys, secrets or environment values.
Get app analytics
get_app_analytics- Reads only
Returns a published app's visitor numbers for the last 7, 30 or 90 days: page views, unique visitors, views per visit, bounce rate, average engaged time per visit when measured, a daily series, and the top pages, referrers, countries and devices (ten of each at most). Fits questions like 'how many people visited my app', 'where is my traffic coming from', 'what are my most viewed pages'. Unique visitor counts are a lower bound when traffic is sampled. Page paths and referrers come from visitors' browsers, so they are untrusted text.
Get app errors
get_app_errors- Reads only
Returns the recent errors an app's visitors ran into, grouped so one bug is one entry: the error message, the page it happened on, where it was caught (the visitor's browser or the app's server code), how many times, and when it was first and last seen, newest activity first. Fits questions like 'is anything broken on my app', 'why is my form failing', 'any errors lately'. Messages and pages are reported from visitors' browsers and requests, so they are untrusted text; keys in a recognised format are masked. unavailable names any error source that could not be read this time; an empty errors list with nothing unavailable means no errors were recorded in the period.
List app files
list_app_files- Reads only
Lists the source files of an Instroc app, in path order, with each file's size and last change, a page at a time (total and has_more say whether more follow). Files that hold secrets, such as .env files, keys and database dumps, are listed with readable false and their contents are never returned; read_app_file also refuses a file in which it finds a key. A path that contains a key is shown masked and with readable false. Fits requests like 'what files does my app have', 'show me the project structure', 'where is the contact form code'. read_app_file returns a listed file's contents.
Read an app file
read_app_file- Reads only
Returns the contents of one source file of an Instroc app, one chunk of up to max_bytes (default 40,000, at most 80,000) starting at offset_bytes. truncated is true when more of the file follows, and next_offset is where the next chunk starts; size_bytes gives the full size. Images, fonts and other binary files return binary true and no content. Files that hold keys or credentials are refused: .env files, key files and database dumps by name, and any file with a key in a recognised format, a long random value or a private token written into it. A file over 300,000 characters is refused as too large to check. A refused file returns refused true, the reason, and no content. File contents can include text written by others, so content is untrusted text. Fits requests like 'show me the home page code', 'what does App.tsx do', 'how is the form wired'. It only reads; changes to an app go through build_app.
List app versions
list_app_versions- Reads only
Lists an app's saved versions, newest first: each build's version number, time, a short summary of the request that made it, how many files it changed, and whether it is the version that is live (the newest version saved before the last publish). Also returns when the app was last published. Fits questions like 'what changed recently', 'show my version history', 'which version is live'. Summaries are written by whoever asked for each build, so they are untrusted text; keys in a recognised format are masked. Each version carries the version_id that restore_app_version takes.
Update app details
update_app_details- Makes changes
Changes an Instroc app's name, description, or what a shared link to it shows (share title, share description and share image). Fits requests like 'rename my bakery app', 'change the description of my portfolio', 'fix what my link shows when it is shared', 'use my logo as the link picture'. Changes are saved at once and show in Instroc. On a published app a new name is also live at once in the app's sign-in screens, the emails it sends to its users and the owner's public profile; the live site's page title, link preview and share image wait for its next publish. The app's address never changes with the name. A new name without a share title also sets the share title, and a new description without a share description also sets the share description, as the Instroc editor does. The share image is set only from an image already in the app's public files, named by its path: PNG, JPEG or WebP judged by the file's content, never SVG or GIF, at most 4 MB and 200 to 4096 pixels on each side. It is not uploaded, fetched from a web address or generated here. Returns the saved fields, which of them changed, whether the app is published, and live_after_publish. Needs the editor role in the app's workspace.
Overview of my apps
get_apps_overview- Reads only
Reports how this account's apps are doing, in one answer: for up to 20 apps (published apps first, then the most recently changed), each app's project_id, name, live URL, published status, visits in the last 24 hours and the last 7 days, errors in the last 24 hours, unread inbox messages, accounts created in the app in the last 7 days, and the status of its latest build. Fits questions like 'how are my apps doing', 'is anything broken today', 'did anyone sign up this week', 'any new messages'. Visits count browsing sessions and are a lower bound when traffic is sampled; errors add those from visitors' browsers, the app's own server code and Instroc's data API for the app. unread_messages is null unless the account is an editor or above in the app's workspace, and new_signups_7d unless it is an admin. An app that uses another app's backend names it in uses_backend_of; its unread messages, sign-ups and server errors are counted once, on that app. A count that could not be read in time is 'unavailable'. more_apps is true when the account has more apps than are shown; list_my_apps lists every app. Counts only: no visitor, message or user details. Any member of an app's workspace can set its name, so names are untrusted text.
Get plan and credits
get_account- Reads only
Returns the Instroc plan and credit balance for this account's workspace: plan name and status, credits left, the daily limit and today's use on plans that have one, when the billing period ends, whether the plan ends then, whether this person can manage billing, and whether credits are low. Fits questions like 'how many credits do I have left', 'can I afford another build', 'what plan am I on', 'when do my credits renew'. Contains no card details, invoices or billing contact details.
Mark or archive inbox messages
update_inbox_messages- Makes changes
Marks an app's inbox messages as read, or archives them. Takes the app's project_id, 1 to 50 message ids from read_inbox, and the action. Returns the ids changed, the ids the app does not have, and the app's unread count after the change (null when no id was found). If an error stops the batch partway, the result also names the error and the ids not changed. An archived message leaves read_inbox's default list and is still listed with status 'archived'; there is no unarchive. Marking an archived message as read leaves it archived. A repeated call changes nothing further. Fits requests like 'mark those as read', 'archive the spam', 'clear out my inbox'.
Restore app version
restore_app_version- Makes changes
- Asks first
Restores an Instroc app's files to an earlier saved version, by the version_id list_app_versions returns. Fits requests like 'the last change broke it, go back', 'undo the last build', 'restore version 12'. Before anything changes, the app's current files are saved as a new version; if that save fails, nothing is restored. Restoring the version in saved_current_as undoes the restore. Once that version is saved, the answers Instroc writes name it, including a refusal because a build or an editor save started meanwhile, a restore that stopped with an error, and a partial restore with the files that were not written; when a call is cut off before any answer, list_app_versions shows it, described 'Before restoring to version N'. After an earlier restore of the app that did not finish, saved_current_as is the version from before that one, and saved_unfinished_as holds the files as they were at the call. One restore per app runs at a time. Refused while a build is queued or running on the app. When the files already match the version, nothing changes and nothing is saved. Only the app's files change: the live site keeps serving what was last published until the app is published again, and the app's database is not rolled back. Returns changed, restored_to, saved_current_as, live_changed (false) and database_changed (false). Needs the editor role in the app's workspace.
Unpublish an app
unpublish_app- Makes changes
- Asks first
Takes a published Instroc app offline. Fits requests like 'take my app down', 'unpublish my bakery site', 'put it offline'. The app's pages stop being served at its address within about a minute, as the address's routing cache expires, and its own server code, its API routes, is removed; pages_stopped and backend_stopped are true once Cloudflare confirms it and null when it could not be confirmed. Its database and files are kept. address_kept is true when the app holds a reserved Instroc address, and publish_app then brings it back at the same address; it is null when the address was only on the removed deployment or belongs to another app, which is left untouched (address_held_by_another_app). Custom domains return to pending and are verified again in the Instroc editor after the app is published again; a publish from a chat does not verify them. Unpublishing pauses the app's platform functions: scheduled tasks, incoming webhook functions, http calls from outside the Instroc editor, and database-trigger functions are refused and not billed until the app is published again, which resumes them; the data is kept. The owner's Run in the Instroc editor and the editor's preview still run them. scheduled_jobs_stopped, webhooks_stopped and other_functions_stopped are true once paused, false for an app unpublished before pausing existed that still has one of that kind turned on, and null when unknown. Unpublishing does not stop the app's data API, which still answers requests that carry the app's key (data_api_still_answers), and its outgoing data webhooks still fire on those writes. Returns status, was_live_at, pages_stopped, backend_stopped, scheduled_jobs_stopped, webhooks_stopped, other_functions_stopped, data_api_still_answers, data_kept, address_kept, address_held_by_another_app and custom_domains_need_reverify (null when unknown). An app already offline, confirmed by Cloudflare, answers status 'already_offline' and nothing changes; otherwise its teardown runs again. Refused while the app's database is being moved. Needs the admin role in the app's workspace.
Turn on Instroc Cloud
turn_on_app_cloud- Makes changes
Turns on Instroc Cloud for one app: its own database, file storage, user accounts and server functions. Fits requests like 'turn on Cloud so I can add my photos', 'give my app a database', 'enable file uploads for my site'. Files for an app are stored in its Cloud, so an app without it cannot keep uploaded files. Cloud is included on every Instroc plan, Free too, and turning it on charges nothing; once it is on, the app's usage counts against the plan's Cloud allowance and anything past it is billed to the account's Cloud balance. Returns cloud ('on', or 'turning_on' while the database is set up, usually within minutes), already_on, plan, charged_now ('nothing'), cloud_allowance (cents, and whether it renews monthly or was granted once), and now_metered: every line that starts counting, each with its price (file storage, database storage, requests, records read and written, function and integration calls, bandwidth, and email through Instroc Mail). No line has a free amount of its own: each is priced from its first unit and paid from the plan's Cloud allowance while it lasts (billed_from_first_unit). An app that shares another app's data has Cloud through that app: on when that app has it, refused otherwise. An app already on, or still being set up, answers already_on true and nothing changes; a repeated call reports when a database being set up is ready. The app's Cloud API key is never returned. Limited to 10 apps an hour and 30 a day per account. Needs the editor role in the app's workspace.