How to use task functions in Superinterface

Task functions let your assistant schedule messages that are posted later or on a recurring basis. They are perfect for reminders, daily digests, or any repeated work.
This guide covers the four built‑in task tools you can add to your assistant:
Create task – schedule a new message
List tasks – view upcoming tasks
Update task – modify an existing task
Delete task – remove a task
For an overview of how scheduling works, see the Tasks guide.

Add task functions

    Open your assistant in the dashboard and go to the Functions tab.
    Click New function and choose Create task, List tasks, Update task, or Delete task.
    Give each function a clear name, like createTask or listTasks.
    Optionally set a key template to scope tasks. Use {{variable}} placeholders from thread metadata to generate the key. Tasks with the same key form a shared pool across assistants.
When the assistant calls one of these tools, Superinterface validates the schedule and stores the task in your workspace.

Scheduling format

When your assistant calls createTask or updateTask, it supplies a schedule in the JSCalendar format. At a minimum provide a start time in ISO 8601. Optionally include a timeZone and recurrenceRules for repeating tasks.
Example daily schedule:
{ "start": "2025-07-01T09:00:00Z", "recurrenceRules": [{ "frequency": "daily" }] }
listTasks, updateTask, and deleteTask can be used to inspect or modify scheduled work. You can also manage tasks directly using the Tasks REST API.
All scheduled tasks appear in the Tasks page of your dashboard where you can inspect and remove them manually.
With these functions your assistant can automate messages and perform work on a schedule without manual intervention.