Documentation Index Fetch the complete documentation index at: https://usegately.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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
Navigate to Tasks in your dashboard
Click Create Task or use the quick-add button
Enter task details (title, description, assignee)
Set priority and due date
Add to a project or board
Task Properties Property Description Title Task name/title Description Detailed task description (supports markdown) Status Current status (To Do, In Progress, Done, etc.) Priority Low, Medium, High, Urgent Assignee Team member responsible Due Date Task deadline Labels Custom tags for categorization Project Parent project/board Attachments Files attached to the task
Task Boards Board Views View Description Kanban Drag-and-drop columns by status List Traditional list view Calendar Tasks displayed on calendar Timeline Gantt-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 Status Description 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 })
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
// 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 Option Description 1h1 hour before 1d1 day before 3d3 days before 1w1 week before Custom Specific 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 Event Description 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 channelsGitHub : Link tasks to issues/PRsZapier : Automate task workflowsCalendar : Sync due dates to Google/OutlookWebhooks : Custom integrations 