Skip to main content
Tasks are reminders or follow-ups that your team needs to action. Each task has a title, description, status, priority and can be assigned to a user or a machine user. Tasks can also be linked to a company or a tenant to give them context.
For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.
Tasks live alongside threads in the Plain app but are not threads themselves. They are a lighter-weight to-do, useful for things like “send onboarding follow-up next Friday” or “check in on this customer after their renewal”. Use the API when you want tasks to be created or updated as a side-effect of something happening in your own systems (for example, automatically creating a follow-up task when a deal closes in your CRM). Plain also raises tasks itself. When Ari can’t answer a customer from your knowledge sources, it records a knowledge gap and creates a task to fill it. Read the gap from the task’s sourceLinks; see Get the knowledge gap behind a task. Subscribe to task webhook events to react to tasks created, updated, or deleted in Plain, including tasks raised for knowledge gaps.