Skip to main content
Gately Task Management helps you organize work, track progress, and collaborate with your team. Create tasks, assign members, set deadlines, and monitor project status all in one place.

​
Features

Task Boards

Kanban-style boards for visual task management

Assignments

Assign tasks to team members

Due Dates

Set deadlines and reminders

Labels & Tags

Organize tasks with custom labels

​
Creating Tasks

​
Via Dashboard

  1. Navigate to Tasks in your dashboard
  2. Click Create Task or use the quick-add button
  3. Enter task details (title, description, assignee)
  4. Set priority and due date
  5. Add to a project or board

​
Task Properties

PropertyDescription
TitleTask name/title
DescriptionDetailed task description (supports markdown)
StatusCurrent status (To Do, In Progress, Done, etc.)
PriorityLow, Medium, High, Urgent
AssigneeTeam member responsible
Due DateTask deadline
LabelsCustom tags for categorization
ProjectParent project/board
AttachmentsFiles attached to the task

​
Task Boards

​
Board Views

ViewDescription
KanbanDrag-and-drop columns by status
ListTraditional list view
CalendarTasks displayed on calendar
TimelineGantt-style timeline view

​
Creating Boards

// Create a new task board via SDK
const board = await gately.tasks.createBoard({
  name: 'Product Launch',
  description: 'Q1 product launch tasks',
  columns: ['Backlog', 'To Do', 'In Progress', 'Review', 'Done']
})

​
Managing Tasks

​
API Access

# List all tasks
curl -X GET "https://api.usegately.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: your-project-id"

# Create a task
curl -X POST "https://api.usegately.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: your-project-id" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Design homepage mockup",
    "description": "Create initial design for the new homepage",
    "status": "todo",
    "priority": "high",
    "assignee_id": "member_123",
    "due_date": "2025-02-15"
  }'

# Update a task
curl -X PATCH "https://api.usegately.com/api/v1/tasks/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: your-project-id" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress"
  }'

# Delete a task
curl -X DELETE "https://api.usegately.com/api/v1/tasks/{task_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Project-ID: your-project-id"

​
SDK Usage

import { Gately } from '@gately/sdk'

const gately = new Gately({ apiKey: 'YOUR_API_KEY' })

// List tasks
const tasks = await gately.tasks.list({
  status: 'in_progress',
  assignee: 'member_123'
})

// Create a task
const task = await gately.tasks.create({
  title: 'Review pull request',
  description: 'Review and approve PR #42',
  priority: 'medium',
  due_date: '2025-01-20'
})

// Update task status
await gately.tasks.update(task.id, {
  status: 'done'
})

// Delete a task
await gately.tasks.delete(task.id)

​
Task Statuses

​
Default Statuses

StatusDescription
backlogTasks not yet scheduled
todoReady to be worked on
in_progressCurrently being worked on
reviewAwaiting review/approval
doneCompleted tasks
archivedArchived/closed tasks

​
Custom Statuses

Create custom statuses for your workflow: 
await gately.tasks.createStatus({
  name: 'QA Testing',
  color: '#8B5CF6',
  position: 3 // Order in the workflow
})

​
Labels & Tags

Organize tasks with custom labels: 
// Create a label
const label = await gately.tasks.createLabel({
  name: 'Bug',
  color: '#EF4444'
})

// Add label to task
await gately.tasks.addLabel(taskId, label.id)

// Filter tasks by label
const bugs = await gately.tasks.list({
  labels: ['bug', 'critical']
})

​
Assignments

​
Assigning Tasks

// Assign a task to a member
await gately.tasks.assign(taskId, {
  assignee_id: 'member_123'
})

// Assign multiple members
await gately.tasks.assign(taskId, {
  assignee_ids: ['member_123', 'member_456']
})

​
Notifications

Assignees receive notifications for:
  • New task assignments
  • Due date reminders
  • Task updates and comments
  • Status changes

​
Comments & Activity

​
Adding Comments

// Add a comment to a task
await gately.tasks.addComment(taskId, {
  content: 'Great progress! Just a few tweaks needed.',
  mentions: ['member_456'] // Optional: mention team members
})

// List task comments
const comments = await gately.tasks.listComments(taskId)

​
Activity Log

Track all task activity: 
const activity = await gately.tasks.getActivity(taskId)
// Returns: status changes, comments, assignments, etc.

​
Subtasks

Break down tasks into smaller subtasks: 
// Create a subtask
await gately.tasks.createSubtask(parentTaskId, {
  title: 'Write unit tests',
  assignee_id: 'member_123'
})

// List subtasks
const subtasks = await gately.tasks.listSubtasks(parentTaskId)

// Toggle subtask completion
await gately.tasks.toggleSubtask(subtaskId, { completed: true })

​
Due Dates & Reminders

​
Setting Due Dates

await gately.tasks.update(taskId, {
  due_date: '2025-02-01',
  reminder: '1d' // Remind 1 day before
})

​
Reminder Options

OptionDescription
1h1 hour before
1d1 day before
3d3 days before
1w1 week before
CustomSpecific date/time

​
Webhooks

Trigger webhooks on task events: 
{
  "event": "task.created",
  "task_id": "task_123",
  "data": {
    "title": "Design homepage mockup",
    "status": "todo",
    "priority": "high",
    "assignee_id": "member_123"
  },
  "created_at": "2025-01-15T10:00:00Z"
}

​
Available Events

EventDescription
task.createdNew task created
task.updatedTask details updated
task.deletedTask deleted
task.status_changedStatus changed
task.assignedTask assigned
task.comment_addedComment added
task.due_soonDue date approaching

​
Integrations

Connect task management to external services:
  • Slack: Get task notifications in channels
  • GitHub: Link tasks to issues/PRs
  • Zapier: Automate task workflows
  • Calendar: Sync due dates to Google/Outlook
  • Webhooks: Custom integrations