Overview

The Tasks API (Quick Tasks) enables you to manage tasks, sub-tasks, and task boards programmatically. Create, update, and track tasks assigned to your team members.

Key Concepts

Task Boards

Task boards are containers that organize tasks. Each account can have multiple task boards for different departments, projects, or workflows.

Tasks

Tasks are work items assigned to users with:

• Title and description
• Start time and due date
• Status (draft, published, completed)
• Labels for categorization
• Sub-tasks for breaking down work
• Attachments

Task Types

Task Statuses

Group Tasks vs Individual Tasks

• Group task: Multiple userIds in one request - all users see the same task
• Individual tasks: Separate API calls for each user - each gets their own task instance

📝

Assignment Rule

If userIds is empty, the task status must be draft and cannot be archived. Tasks must have assigned users to be published.

---

Available Endpoints

Task Boards

Tasks

Labels

Sub-Tasks

---

Constraints

---

Authentication

All endpoints require authentication via API key or OAuth 2.0.

Required Scopes

---

Attachments

To add attachments to task descriptions:

1. Upload files via the Attachments API with featureType: quicktasks
2. Include the fileId in the task description

⚠️

Attachment Replacement

When updating a task, new attachments replace existing ones. Include all attachments you want to keep in the update request.

---

Guide Pages

---

API Reference