How to Use Tasks in Superinterface
Tasks in Superinterface allow your assistants to send messages on a schedule and execute work "while-you-sleep". This is perfect for repetitive scheduled work like social media posting, reminders, daily reports, or any other repetitive tasks.
1. Add task functions to your assistant
Open your assistant in the Superinterface dashboard.
Go to the Functions tab and click New function.
Choose Create task, List tasks, Update task, or Delete task. Each one becomes a tool the assistant can call.
Optionally provide a key template to scope tasks. Placeholders like {{threadId}}
pull values from the thread metadata.
When the assistant calls one of these tools, Superinterface validates the schedule, stores the task in your workspace, and automatically posts the task message at the specified time so the assistant can respond.
2. Define schedules
When your assistant calls createTask it passes the schedule details. Schedules use the JSCalendar format. At a minimum provide a start
ISO 8601 time. Optionally add a timeZone
and recurrenceRules
for repeating tasks.
Example daily schedule:
{
"start": "2025-07-01T09:00:00Z",
"recurrenceRules": [{ "frequency": "daily" }]
}
Tasks can be one-off or repeat according to the recurrence rules you provide.
3. View and manage tasks
All scheduled tasks appear in the Superinterface Cloud dashboard under the Tasks menu. From there you can inspect the target thread and delete tasks if needed.
You can also manage tasks programmatically using the REST API. See the Tasks API reference for details on listing, updating, or deleting tasks.
4. What happens when a task triggers?
When the scheduled time arrives, Superinterface posts the task message into the thread and starts a run. Any tool calls—like creating additional tasks—are processed as usual. Recurring tasks continue according to their schedule.
With tasks you can automate social media posts, regular digests, tool calls, and more without manual effort.