Reference

Grant switches

What each of Recued's own switches on a contract lets an AI or a recipe do.

A contract is the saved list of what one actor may do. Each line on it is a switch. A switch that is on is a grant: a yes you give ahead of time.

This page lists Recued's own switches. Packs add their own. On the Contracts page, a pack switch shows the words its pack wrote.

This page is made from the same words the Contracts page shows. So the two always say the same thing.

#Three kinds of switch

  • AI tools. An AI app, or your own chat, calls these by name. Recipes do not.
  • Operations. These are the steps a recipe can take. Some AI tools check one before they act.
  • Data switches. These say which of your data an AI or a recipe may read.

Turning an operation off stops an AI from using it on its own. A recipe you allow on that contract can still run it as a step. To stop that too, turn the recipe off. See Grants and approvals.

#How an AI tool joins up

An AI tool often needs more than its own switch. Say you turn on work.create. It still adds no task until core.work-entity.task.create is on too.

A contract you make for an AI app starts with every switch off. So turn on each tool you want, and then the switches it needs. On the Contracts page, they are listed under each tool. You can turn them on right there. The tables below list them too.

#AI tools

Each tool says what else it needs.

Switch What it does
account.search Search CRM accounts. Searches the companies copied from your CRM. To search the CRM itself, the search switch of that CRM must be on too.
calendar.create Add a calendar event. Adds an event to your calendar. Needs core.data.calendar.create.
calendar.search Search your calendar. Finds events by title, place or who is coming. Needs data.calendar.
calendar.update Change a calendar event. Changes an event on your calendar. Needs core.data.calendar.update.
contact.read Read the details of a contact. Reads the title, birthday, address and relationship of one contact. Needs data.contact.
contact.search Search your contacts. Finds people in your contacts by name, email, phone, company or nickname. Needs data.contact for your own contacts. To search the CRM itself, the search switch of that CRM must be on too.
contact.write Add or change a contact. Adds a contact, or changes a contact's name, phone, company, birthday or anniversary. You approve each one. Needs core.contact.write and data.contact. A contact's relationship and privacy marks stay yours to set, in Contacts.
deal.search Search CRM deals. Searches the deals copied from your CRM. Needs data.contact to show the contact on a deal. To search the CRM itself, the search switch of that CRM must be on too.

#AI tools, part 2

Each tool says what else it needs.

Switch What it does
document.read Read a document. Reads the text of a file, like an email attachment or a stored PDF. Needs data.file. Also needs core.storage.data-file-read for a plain text file and core.storage.file.read-temp for a document it converts. To convert a document, the MarkItDown or Docling pack must be installed, with its convert switch on.
document.search Search document contents. Finds words inside saved files and attachments, with excerpts and file links. Needs data.file. Also needs core.storage.data-file-read to read text and verify saved matches and core.storage.file.read-temp to read converted documents. Uses installed MarkItDown or Docling when conversion is needed. Shows files it could not search.
enrichment.search Search worked-out facts. Finds facts Recued worked out about records, like a score or a summary. Each kind of fact also needs its own switch on the Entities tab.
episode.record Record your day. Records what you did or skipped on a day, in your words, as your history. Needs core.situation.record. Naming an item from your agenda also needs the read switch for that kind of item.
file.search Search your files. Finds files in your connected folders. Needs data.file.
mail.read Read an email. Reads one email in full and lists its attachments. Needs data.mail. Also needs data.file to list attachments.
mail.search Search your mail. Searches your mail by subject, sender, words or date. Needs data.mail.

#AI tools, part 3

Each tool says what else it needs.

Switch What it does
memory.forget Forget a saved fact. Forgets a fact the AI saved earlier. You can bring it back. Needs core.memory.write.
memory.relations Look up how to save a fact about someone. Tells an AI how to save a fact about a person or a thing, like "Mia is Dana's daughter". Then one fact is saved the same way each time. Needs core.memory.write.
memory.search Search your memory. Finds facts and notes saved in your memory. Needs core.memory.read.
memory.write Save to your memory. Saves a fact to your memory. You can see it and undo it. Needs core.memory.write.
recipe.run Run a recipe. Runs one of your recipes. Each step of the recipe needs its own switch here, unless the recipe is on under Recipes.
recipe.schedule Schedule a recipe. Sets a recipe to run later or on a timer. Needs core.schedule.recipe. Only you can schedule, from your own chat. An AI app that connects with a key cannot.
recipe.stop Stop a recipe. Stops a recipe run that the same conversation started.
schedule.list Read scheduled requests. Lists saved requests and their timing. Needs core.schedule.prompt.
schedule.pause Pause a scheduled request. Stops future and queued occurrences. A turn already running can finish. Needs core.schedule.prompt.
schedule.remove Remove a scheduled request. Removes future and queued occurrences. The conversation and its history remain. Needs core.schedule.prompt.

#AI tools, part 4

Each tool says what else it needs.

Switch What it does
schedule.resume Resume a scheduled request. Starts future occurrences of a paused request. Needs core.schedule.prompt.
schedule.run_prompt Schedule an AI request. Runs a saved request later in its own conversation. Needs core.schedule.prompt.
schedule.update Edit a scheduled request. Changes the saved request or its timing. Needs core.schedule.prompt.
situation.query Ask what is going on. Gets a short, ranked picture of what is going on around a time. Needs core.situation.read. Each kind of item in the picture also needs its own read switch and data switch.
work.create Add a task, note or more. Adds a task, note, commitment, project or thing you own. Needs core.work-entity.task.create to add tasks, core.work-entity.note.create to add notes, core.work-entity.commitment.create to add commitments, core.work-entity.project.create to add projects and core.work-entity.asset.create to add things you own.
work.read Read a task, note or more. Reads one task, note, commitment, project, booking or thing you own in full. Needs core.work-entity.read. Also needs data.task for tasks, data.note for notes, data.commitment for commitments, data.project for projects, data.booking for bookings and data.asset for things you own.

#AI tools, part 5

Each tool says what else it needs.

Switch What it does
work.search Search tasks, notes and more. Finds tasks, notes, commitments, projects, bookings and things you own. Needs core.work-entity.read. Also needs data.task for tasks, data.note for notes, data.commitment for commitments, data.project for projects, data.booking for bookings and data.asset for things you own.
work.type Look up a type of thing you own. Tells an AI which dates and reminders a type of thing has, such as a passport, before it adds one. Needs core.work-entity.asset.create.
work.update Change a task, note or more. Changes a task, note, commitment, project or thing you own, or ticks a task off. Needs core.work-entity.task.update to change tasks, core.work-entity.note.update to change notes, core.work-entity.commitment.update to change commitments, core.work-entity.project.update to change projects, core.work-entity.asset.update to change things you own and core.work-entity.task.mark-done to tick a task off.

#Operations

Recipes use these as steps. Some AI tools check one before they act. They are grouped below by what they reach, the same way the Contracts page groups them.

#Mail

Switch What it does
core.mail.body-read Read the full text of an email. Reads the whole text of one email.
core.mail.delete Delete an email. Deletes one email from your mail account and from your server.
core.mail.draft.create Save a new draft. Saves a new email draft on your server. Nothing is sent.
core.mail.draft.delete Delete a saved draft. Deletes an email draft saved on your server.
core.mail.draft.read Read a saved draft. Reads an email draft saved on your server.
core.mail.draft.save-to-mailbox Put a draft in your mailbox. Copies a saved draft into the Drafts folder of your mail account. You can finish it in your mail app.
core.mail.draft.update Change a saved draft. Changes an email draft saved on your server.
core.mail.email.get Read one stored email. Reads one email from a mailbox stored on your server, by its id.
core.mail.email.list List stored emails. Lists emails from a mailbox, picked by sender, folder, date and more.
core.mail.email.search Search stored emails. Searches the words in the emails stored on your server.
core.mail.fact.get Read one mail fact. Reads one thing Recued found in your mail, like a parcel or a bill, and the facts behind it.
core.mail.fact.list List mail facts. Lists the parcels, orders and bills Recued found in your mail, newest first.
core.mail.flag Flag an email. Stars or flags one email, or takes the flag off.
core.mail.get Read one email. Reads one email from the copy of your mail on your server.

#Mail, part 2

Switch What it does
core.mail.mark Mark an email read or unread. Marks one email read or unread, in your mail account and on your server.
core.mail.move Move an email to a folder. Files one email into another folder or label.
core.mail.notify-booking-visitor Email the visitor of a booking. Tells the person behind a booking that it changed. Recued finds their address itself, so the recipe never sees it.
core.mail.send Send an email. Sends an email from one of your mail accounts.
core.mail.sent.reconcile Check that an email really went. Asks your mail provider whether an email Recued sent really left, and records the answer.
core.mail.thread-read Read an email thread. Puts every email in one thread together, oldest first.

#Calendar

Switch What it does
core.data.calendar.create Create a calendar event. Adds an event to one of your calendars. Needed by calendar.create.
core.data.calendar.delete Delete a calendar event. Deletes an event from one of your calendars.
core.data.calendar.get Read one calendar event. Reads one event from the copy of your calendar on your server.
core.data.calendar.list List calendar events. Lists events from one calendar, or from all of them, in time order.
core.data.calendar.rsvp Answer an invitation. Says yes, no or maybe to a meeting invitation, for you.
core.data.calendar.search Search calendar events. Searches the titles, notes and places of your events.
core.data.calendar.stat Check a calendar event. Checks whether an event exists and reads its time and status, without the details.
core.data.calendar.update Change a calendar event. Changes an event on one of your calendars. Needed by calendar.update.

#Contacts

Switch What it does
core.contact.business-context See the business links of a contact. Counts the deals, tasks, meetings, bookings and projects linked to one contact. It uses no AI.
core.contact.engagements.read See your history with a contact. Lets an AI read the emails, meetings and other contact you have had with one person.
core.contact.resolve Find a contact. Finds a contact from an email, a phone number, a nickname or an account on another site.
core.contact.upsert Add or update a contact. Adds a contact, or updates the one with the same email.
core.contact.write Change your contacts. Lets an AI add a contact, or change a contact's name, phone, company, birthday or anniversary. Each change waits for your yes, unless you let it run without asking, and then counts as yours. Needed by contact.write.

#Files

Switch What it does
core.storage.csv.columns Read spreadsheet columns. Reads the column names of a CSV file.
core.storage.csv.filter Save matching spreadsheet rows. Saves the rows of a CSV file that match into a new file.
core.storage.csv.inspect Inspect a spreadsheet. Reads column names, row counts and a small sample from a CSV file. Saves nothing.
core.storage.csv.rows Search a spreadsheet. Returns the rows of a CSV file that match, and saves nothing.
core.storage.csv.stats Sum up a spreadsheet. Counts the rows of a CSV file and sums up each column.
core.storage.csv.transform Create a spreadsheet from other files. Filters, joins, compares or sums up CSV files and saves a new file. The source files stay the same.
core.storage.data-file-read Read a received file. Reads a file your server received, like an email attachment. Needed by document.search to read text and verify saved matches, and by document.read for a plain text file.
core.storage.file.delete Delete a file. Deletes one file from a connected folder.
core.storage.file.fetch-remote Fetch files from connected apps. Lets Recued fetch what is in a file from a connected app, like a cloud drive. It applies to the whole server.
core.storage.file.folders List your folders. Lists your connected folders, and whether a file can be saved into each one.
core.storage.file.get Read one stored file. Reads one file stored on your server, by its id.
core.storage.file.list List files. Lists the files in a connected folder.

#Files, part 2

Switch What it does
core.storage.file.move Move a file. Moves a file to another place.
core.storage.file.persist Keep a file a step made. Keeps a file that a recipe step made, so it is not thrown away when the run ends.
core.storage.file.put-ref Copy a file into a folder. Writes a stored file into a named place in a connected folder.
core.storage.file.read Read a file. Reads what is in one file in a connected folder.
core.storage.file.read-temp Read a file a step made. Reads a file that an earlier step in the same run made. Needed by document.search to read converted documents, and by document.read for a document it converts.
core.storage.file.render-markdown-template Fill in a document template. Fills a Markdown template with a few set values, like a name and a date.
core.storage.file.save-to-folder Save a file into a folder. Saves a stored file, like an email attachment, into the folder you named.
core.storage.file.set-scan-status Record a virus scan result. Marks a received file as clean or flagged, after a virus scan.
core.storage.file.stat Check a file. Checks whether a file exists and reads its size and date, without what is in it.
core.storage.file.write Write a file. Saves a file into a connected folder.
core.storage.ics.read Read a calendar file. Reads a calendar file, like an emailed invitation, and saves nothing.

#Shared store

Switch What it does
core.storage.shared.compare-and-set Save a value only if unchanged. Saves a value only if nobody changed it since it was read.
core.storage.shared.delete Delete a value. Deletes one saved value.
core.storage.shared.delete-prefix Delete values by name. Deletes every saved value whose name starts the same way.
core.storage.shared.list List values. Lists the saved values whose names start the same way.
core.storage.shared.patch Change part of a value. Changes some fields of a saved value and leaves the rest.
core.storage.shared.read Read a value. Reads one saved value by its name.
core.storage.shared.search Search values. Searches the words in saved values.
core.storage.shared.write Save a value. Saves a value under a name in the shared store, where recipes keep notes between runs.

#Memory

Switch What it does
core.memory.annotation.create Add a note to a record. Sticks a small labelled fact onto a record, like a contact or an email.
core.memory.annotation.delete Remove notes from records. Removes the labelled facts that this recipe stuck onto records.
core.memory.annotation.list List notes on records. Lists the labelled facts stuck onto records.
core.memory.annotation.search Search notes on records. Searches the words in the labelled facts stuck onto records.
core.memory.link.create Link two records. Records that two things belong together, like an email and the contact who sent it.
core.memory.link.delete Remove links. Removes the links between records that match, whoever made them.
core.memory.link.list List links. Lists the links between records.
core.memory.read Read your memory. Lets an AI search the facts and notes saved in your memory. Needed by memory.search.
core.memory.timeline.read Read the timeline of a record. Lists everything about one person or thing in date order: mail, events, notes and more.
core.memory.write Save to your memory. Lets an AI save a fact to your memory, or forget one it saved. You see each one and can undo it. Needed by memory.relations, memory.write and memory.forget.

#Audit trail

Switch What it does
core.audit.read Read run history. Lets an AI read what your recipes did, and when.

#Enrichments

Switch What it does
core.data.enrichment.describe See which facts exist. Lets an AI see the kinds of facts Recued works out, and what each one holds.
core.data.enrichment.list List worked-out facts. Lists the facts Recued worked out about records, newest first.
core.data.enrichment.read Read worked-out facts. Lets an AI read the facts Recued worked out about a record.
core.data.enrichment.upsert Save a worked-out fact. Saves a fact Recued worked out about a record, like a score or a summary.
core.data.enrichment.vector-search Search facts by meaning. Lets an AI find worked-out facts that mean something close to what it asks.

#Tasks & notes

Switch What it does
core.work-entity.asset.create Add a thing you own. Adds a thing you keep track of, like a car or a device, and where its facts came from. Needed by work.type, and by work.create to add things you own.
core.work-entity.asset.delete Delete a thing you own. Deletes a thing you keep track of, with its readings.
core.work-entity.asset.observe Record a reading. Lets a recipe record a reading, like a meter value, for a thing you own. It records only what you allowed.
core.work-entity.asset.update Change a thing you own. Changes the facts about a thing you keep track of. Needed by work.update to change things you own.
core.work-entity.booking.create Create a booking. Adds a booking: who the customer is, when it is, and what it is worth.
core.work-entity.booking.delete Delete a booking. Deletes a booking.
core.work-entity.booking.update Change a booking. Changes a booking, which is also how a booking is cancelled or finished.
core.work-entity.commitment.cancel Cancel a commitment. Marks a commitment as cancelled.
core.work-entity.commitment.create Create a commitment. Adds a commitment: a promise you made, or one made to you. Needed by work.create to add commitments.
core.work-entity.commitment.fulfill Mark a commitment kept. Marks a commitment as kept.
core.work-entity.commitment.propose Suggest a commitment. Suggests a commitment for you to check. It is only added once you say yes.

#Tasks & notes, part 2

Switch What it does
core.work-entity.commitment.update Change a commitment. Changes the details of a commitment. Needed by work.update to change commitments.
core.work-entity.customer-account-payment.apply Record a customer payment. After you check it, records a payment from a customer across the invoices it pays.
core.work-entity.customer-account-payment.correct Correct a customer payment. After you check it, corrects or cancels how a payment was split across invoices.
core.work-entity.customer-invoice.credit Credit a customer invoice. After you check it, records a credit on an invoice and lowers what is still owed.
core.work-entity.customer-invoice.credit.correct Correct an invoice credit. After you check it, undoes a credit on an invoice and can add a new one in its place.
core.work-entity.customer-payment.correct Correct an invoice payment. After you check it, corrects or cancels one payment and fixes what the invoice still owes.
core.work-entity.customer-refund.apply Record a customer refund. After you check it, records a refund to a customer.
core.work-entity.customer-refund.correct Correct a customer refund. After you check it, undoes a wrong refund record and can add a new one in its place.
core.work-entity.get Read one task, note or more. Lets a recipe read one item, like a task or a note, by its id.
core.work-entity.list List tasks, notes and more. Lets a recipe list the items of one kind: tasks, notes, commitments, projects, bookings or things you own.

#Tasks & notes, part 3

Switch What it does
core.work-entity.note.create Create a note. Adds a note. It goes on your server unless the recipe picks a connected app. Needed by work.create to add notes.
core.work-entity.note.delete Delete a note. Deletes a note.
core.work-entity.note.update Change a note. Changes the fields of a note. Needed by work.update to change notes.
core.work-entity.project.archive Archive a project. Moves a project to the archive.
core.work-entity.project.create Create a project. Adds a project. It goes on your server unless the recipe picks a connected app. Needed by work.create to add projects.
core.work-entity.project.update Change a project. Changes the fields of a project. Needed by work.update to change projects.
core.work-entity.quote-completion.review Close or reopen a finished job. After you approve, closes the task for work the customer accepted, or reopens it for changes.
core.work-entity.quote-signoff.release Release an accepted quote. After you approve, turns an accepted quote into a task and an invoice.
core.work-entity.read Read tasks, notes and more. Lets an AI read and search your tasks, notes, commitments, projects, bookings and things you own. Each kind also needs its own data switch. Needed by work.search and work.read.
core.work-entity.task.create Create a task. Adds a task. It goes on your server unless the recipe picks a connected app. Needed by work.create to add tasks.
core.work-entity.task.delete Delete a task. Deletes a task.

#Tasks & notes, part 4

Switch What it does
core.work-entity.task.mark-done Mark a task done. Ticks a task off as done. Needed by work.update to tick a task off.
core.work-entity.task.mark-reminder-fired Mark a reminder task as sent. Marks a reminder kept as a task as sent, so it is no longer due.
core.work-entity.task.update Change a task. Changes the fields of a task. Needed by work.update to change tasks.

#Form responses

Switch What it does
core.data.form-response.get Read one form answer. Reads one answer to a form that you accepted.
core.data.form-response.list List form answers. Lists the answers to your forms that you accepted.
core.data.form-response.set-state Move a form answer along. Marks a form answer as in review, accepted, declined or a no-show.

#Webhooks

Switch What it does
core.webhook.event.get Read a webhook message. Lets the recipe a webhook started read the message that started it.

#Peers

Switch What it does
core.peer.ask Ask the owner of another server. Puts one question to the owner of another Recued server, then waits for the answer.
core.peer.receive-answer Take answers from a peer. Lets the answer to a question you sent come back from that server.
core.peer.receive-ask Take questions from a peer. Lets another Recued server put a question to you. You see it and choose the answer.
core.storage.exchange.status Check a question sent to a peer. Checks what happened to a question you sent to another server.

#Selling

Switch What it does
core.customer.status Let a customer check their access. Lets a customer see the state of their own access.
core.seller.customer-access.close End the access of a customer. Ends the access of a customer.
core.seller.customer-access.extend Extend the access of a customer. Gives a customer more time.
core.seller.customer-access.issue Give a customer access. Gives a paying customer access, or gives them more time.
core.seller.customer-access.swap-tier Move a customer to another tier. Moves a customer to another price tier.
core.seller.offer.attach-fulfillment Link an offer to its recipe. Links an offer to the recipe that delivers it.
core.seller.offer.ensure Set up a draft offer. Sets up a draft of something to sell. It cannot make the offer live.
core.seller.offer.get Read an offer. Reads one of your offers.
core.seller.offer.list List offers. Lists your offers.
core.seller.order.attach-artifact Attach what was delivered. Attaches the finished work the customer paid for to the order.
core.seller.order.attach-payment Link a checkout to an order. Links the checkout of your payment provider to an order, which then waits for payment.
core.seller.order.confirm-payment Confirm an order was paid. Marks an order as paid. Nothing else can.
core.seller.order.confirm-refund Confirm an order was refunded. Marks an order as refunded. Nothing else can.

#Selling, part 2

Switch What it does
core.seller.order.confirm-renewal-payment Confirm a renewal was paid. Marks the order for one renewal as paid, one order for each billing period.
core.seller.order.get Read an order. Reads one order.
core.seller.order.link-customer Link an order to a customer. Links a paid order to the customer who got access.
core.seller.order.link-work-entity Link an order to a task. Links an order to the task or commitment for the work.
core.seller.order.list List orders. Lists your orders.
core.seller.order.open Open an order. Opens an order for one purchase of an offer.
core.seller.order.quote Price an order. Sets the price of an order that is not paid yet.
core.seller.order.transition Move an order along. Moves an order to its next step, like delivering, complete or cancelled.
core.seller.tier.get Read a price tier. Reads one of your price tiers.
core.seller.tier.list List price tiers. Lists your price tiers.

#Notifications

Switch What it does
core.notification.recipe-callback Nudge a connected AI app. Tells an AI app that an answer it asked for may have changed. The app must ask again to see anything. A contract for an AI app cannot get this.
core.notification.send Send you a notification. Sends a message to you on the channels you set up, like Slack, Telegram or email. It cannot reach anyone else.
core.preapproval.request Ask you to approve a future run. Puts a planned recipe run or a saved draft in front of you to approve. It cannot approve anything itself.
core.reminder.create Set a reminder. Sets a reminder for you. Recued sends it once, at the time chosen.

#Conversation history

Switch What it does
core.recall.search Search past conversations. Lets your own chat find what was said in earlier conversations. An AI app cannot use it.

#Reminders

Switch What it does
core.reminder.cancel Cancel a reminder. Cancels a reminder still to come, so it never goes off.
core.reminder.list List your reminders. Lists the reminders still to come, soonest first.
core.reminder.update Change a reminder. Changes the words or the time of a reminder still to come.

#Situations

Switch What it does
core.situation.prefetch Look ahead before each chat turn. Lets Recued add a short picture of what is going on to your chat before the AI answers.
core.situation.read Read what is going on. Reads a short, ranked picture of what is going on around a time. Each kind of item also needs its own switches. Needed by situation.query.
core.situation.record Record your day. Lets an AI record what you did or skipped on a day, in your words. Each day it records waits for your yes. Needed by episode.record.

#AI models

A contract for an AI app cannot get these.

Switch What it does
core.ai.classify Sort into a category. Asks your AI model which category, from a list the recipe gives, fits some text best.
core.ai.compare Compare two things. Asks your AI model how two pieces of data differ and where they match.
core.ai.embed Turn text into numbers for search. Asks your AI model for numbers that stand for what some text means. Search by meaning uses them.
core.ai.extract Pull out fields. Asks your AI model to pull named fields, like a date or an amount, out of free text.
core.ai.generate Draft text. Asks your AI model to write a draft, like an email or an agenda, from data the recipe gives.
core.ai.prompt Ask your AI model anything. Sends the recipe’s own question to your AI model and returns the answer. It cannot search the web.
core.ai.rewrite Rewrite text. Asks your AI model to rewrite text in another style.
core.ai.score Score against a list. Asks your AI model to score data against a list of points.
core.ai.sentiment Read the mood of text. Asks your AI model whether text sounds positive, neutral or negative.
core.ai.summarize Summarize. Asks your AI model for a short summary and the key points of a long text.
core.ai.translate Translate. Asks your AI model to put text into another language.

#Browser

Switch What it does
core.dom.act Act on web pages. Reads, types, clicks and sends forms on web pages in your browser, through the Browser Bridge. It does several steps at once, across tabs. A click or a sent form cannot be undone.
core.dom.click Click on a web page. Clicks a link or a button, or presses a key, on a web page in your browser. It goes through the Browser Bridge. A click or a key can send, post or delete, and cannot be undone.
core.dom.download Save a file from a web page. Saves a file a web page in your browser links to, such as a PDF, among your files. It goes through the Browser Bridge and fetches the file as the page would, signed in as you are.
core.dom.inspect See a whole web page. Reads a web page open in your browser, with its links, buttons and form fields, through the Browser Bridge. Password and card fields come back empty.
core.dom.open Open a web page. Opens a web page in a new tab of your browser, through the Browser Bridge. The page is asked for as you, signed in, and the address can carry data to that site.
core.dom.read Read from a web page. Reads text from a web page open in your browser, through the Browser Bridge.
core.dom.screenshot Take a screenshot of a web page. Takes a picture of a web page open in your browser, through the Browser Bridge. The Bridge brings its tab to the front for a moment. The picture shows the page as you see it. Needs "Allow screenshots" in the Bridge's side panel.

#Browser, part 2

Switch What it does
core.dom.scroll Scroll a web page. Scrolls a web page in your browser a screen at a time. It goes through the Browser Bridge, so what loads as you scroll shows. Changes nothing on the page.
core.dom.table Read a table on a web page. Reads a table on a web page open in your browser as rows of text, through the Browser Bridge. Password and card fields come back empty.
core.dom.tabs See your open tabs. Lists the tabs open in your browser on a site, with their titles, through the Browser Bridge. It can list the ones showing an address.
core.dom.wait Wait for a web page. Waits until part of a web page open in your browser shows or goes, through the Browser Bridge. Changes nothing on the page.
core.dom.write Type into a web page. Types into a web page open in your browser, through the Browser Bridge.

#Schedules

Switch What it does
core.schedule.prompt Scheduled prompts. Lets your own chat create and manage scheduled AI requests. Needed by schedule.run_prompt, schedule.list, schedule.update, schedule.pause, schedule.resume and schedule.remove.
core.schedule.recipe Schedule recipes. Lets your own chat set a recipe to run later or on a timer. An AI app cannot schedule recipes. Needed by recipe.schedule.

#Triggers

A contract for an AI app cannot get these.

Switch What it does
core.watch.http Watch a web page. Starts a recipe when a web page changes.
core.watch.time Run only at set times. Lets a recipe run only on chosen days or hours.
core.watch.time-relative Run before or after a date. Starts a recipe when the time comes near a date on a record, like a day before a meeting.

#Web addresses

Switch What it does
core.http.download Download a file from a web address. Your server downloads a file from a public web address and keeps it among your files. It takes files up to 25 MB, to read or use from there. Nothing of yours is sent with it.
core.http.get Get a web address. Your server fetches a public web address and answers what the site sent: its status, type and text, or JSON. Nothing of yours is sent with it, and only public addresses are fetched, never one on your own network.
core.http.read Read a web address. Your server fetches a public web page and answers its text, as you would read it. Nothing of yours is sent, so a page that needs you signed in is read in your browser instead.

#Recipes

Switch What it does
core.kitchen.draft.get Read Kitchen draft source. Reads source from a draft created through this connection.
core.kitchen.draft.import Import source into Kitchen. Adds recipe or pack source as a draft for you to review. It does not install or run it.
core.kitchen.draft.list List Kitchen drafts. Lists drafts created through this connection without returning their source.
core.kitchen.draft.update Update Kitchen draft source. Saves edited source to a draft created through this connection, checking its revision. It does not install or run it.
core.work-entity.approval-workflow.continue Carry on a job a customer accepted. After you approve, finishes a task, keeps a commitment or starts a saved recipe that a customer accepted.

#Data switches

An AI or a recipe can read only the data whose switch is on.

Switch What it does
data.mail Your mail. Lets an AI or a recipe read the copy of your mail on your server. Needed by mail.search and mail.read.
data.calendar Your calendar. Lets an AI or a recipe read your calendar events. Needed by calendar.search.
data.file Your files. Lets an AI or a recipe read your stored files, like email attachments and files in your folders. Needed by mail.read to list attachments, and by document.search, document.read and file.search.
data.contact Your contacts. Lets an AI or a recipe read your contacts. Needed by contact.search for your own contacts, and by contact.read and contact.write, and by deal.search to show the contact on a deal.
data.task Your tasks. Lets an AI or a recipe read your tasks. Needed by work.search and work.read for tasks.
data.note Your notes. Lets an AI or a recipe read your notes. Needed by work.search and work.read for notes.
data.commitment Your commitments. Lets an AI or a recipe read your commitments: promises you made, or ones made to you. Needed by work.search and work.read for commitments.
data.project Your projects. Lets an AI or a recipe read your projects. Needed by work.search and work.read for projects.
data.booking Your bookings. Lets an AI or a recipe read your bookings. Needed by work.search and work.read for bookings.

#Data switches, part 2

An AI or a recipe can read only the data whose switch is on.

Switch What it does
data.asset Things you own. Lets an AI or a recipe read the things you keep track of, like a car or a device. Needed by work.search and work.read for things you own.
data.form_response Form answers. Lets an AI or a recipe read the answers to your forms.
data.webhook Webhook messages. Lets an AI or a recipe read the messages other websites sent to your server.
data.episode Past episodes. Lets an AI see past times you did something: when, where and with whom. It sees them only inside a situation.
data.occasion Occasions. Lets an AI see the things that come back each year, like a birthday dinner. It sees them only inside a situation.

Recued Docs

Search documentation

Start typing to search the documentation.