Tasks
Every Tasks tool, with the scope it needs, its arguments and the API operation it calls.
30 tools
Archive tasks
Destructiveatlas_tasks_archive
Archive (soft-delete) a task. Reversible via the web UI.
- Scope
tasks:delete- Calls
- Example prompt
- Archive tsk_a1b2c3 - we shipped this last quarter.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Preview task auto schedule
Changes dataatlas_tasks_auto_schedule_preview
Preview an auto-schedule run with custom guardrails (respect existing dues, calendar holds, daily move caps). Never persists.
- Scope
tasks:read- Calls
- Example prompt
- What would the schedule look like if we cap to 5 moves per day?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskIds | array of string | No | |
horizonDays | integer | No | |
guardrails | object | No |
Run task auto schedule
Changes dataatlas_tasks_auto_schedule_run
Run the auto-scheduler over the caller's backlog (or a specific taskIds subset). Pass dryRun=true to preview without persisting.
- Scope
tasks:write- Calls
- POST /tasks/auto-schedule
- Example prompt
- Auto-schedule my next 30 days of work.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskIds | array of string | No | Restrict to specific tasks. Omit to schedule everything in the user backlog. |
horizonDays | integer | No | How many days forward to schedule. |
dryRun | boolean | No | When true, returns the planned moves without persisting. |
Get task board
Read onlyatlas_tasks_board_get
Render the lane x column board view for a board id. Tasks honour the board default filter AND each lane filter.
- Scope
tasks:read- Calls
- GET /tasks/board
- Example prompt
- Show me the engineering board with 50 cards per column.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
boardId | string | Yes | Board id (e.g. brd_...). |
limitPerColumn | integer | No | Per-column page size. |
Create tasks in bulk
Changes dataatlas_tasks_bulk_create
Bulk create up to 200 tasks in a single request. Returns a per-item results array - partial failures (validation, permissions) never abort the batch. Use when migrating data or fanning out from a template.
- Scope
tasks:write- Calls
- Example prompt
- Create these 50 onboarding tasks for the new hire in one call.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
items | array of object | Yes | Up to 200 tasks to create in one request. The response includes a per-item result so partial failures don't lose successful rows. |
Update tasks in bulk
Changes dataatlas_tasks_bulk_update
Bulk update up to 200 tasks in a single request. Each item carries its own patch + optional ifMatchVersion. Partial failures (version conflicts, permissions) come back as per-item errors; successful rows still land.
- Scope
tasks:write- Calls
- Example prompt
- Move every overdue Q3 task to the Q4 milestone in one shot.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
items | array of object | Yes | Up to 200 task updates in one request. Each item carries its own ifMatchVersion when optimistic concurrency is needed. |
Complete tasks
Changes dataatlas_tasks_complete
Convenience: mark a task as DONE.
- Scope
tasks:write- Calls
- Example prompt
- Mark tsk_a1b2c3 as done.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Create tasks
Changes dataatlas_tasks_create
Create a new task. Idempotent: re-runs within 24h return the same task.
- Scope
tasks:write- Calls
- Example prompt
- Add a task: review the Q3 forecast, due Friday, in the Atlas project.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project to create the task in. |
title | string | Yes | Short, human-readable title. |
description | string | No | Optional long-form body. Markdown supported. |
priority | "NONE" | "LOW" | "MEDIUM" | "HIGH" | "URGENT" | No | Importance ranking. |
dueOn | string (date-time) | No | ISO-8601 deadline. |
startsOn | string (date-time) | No | ISO-8601 start date. |
status | string | No | Initial status. Defaults to the project default. |
assigneeId | string | No | User id of the single workspace member to assign. A task takes one assignee on creation. |
labelIds | array of string | No | Label ids to apply. |
estimateMin | integer | No | Estimate in minutes. |
Add task dependencies
Changes dataatlas_tasks_dependencies_add
Add a dependency edge between two tasks (default kind: BLOCKS).
- Scope
tasks:write- Calls
- Example prompt
- Make tsk_a1b2c3 block tsk_zzz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
fromTaskId | string | Yes | Task that owns the dependency edge. |
toTaskId | string | Yes | Task on the other end. |
kind | "BLOCKS" | "DUPLICATES" | "RELATES" | No | Edge kind. |
List task dependencies
Read onlyatlas_tasks_dependencies_list
List blockers + blocking + relates edges for a task.
- Scope
tasks:read- Calls
- Example prompt
- What's blocking task tsk_a1b2c3?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Remove task dependencies
Destructiveatlas_tasks_dependencies_remove
Remove a dependency edge between two tasks.
- Scope
tasks:write- Calls
- Example prompt
- Remove the block from tsk_a1b2c3 to tsk_zzz.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
fromTaskId | string | Yes | |
toTaskId | string | Yes |
Get task dependency insights
Read onlyatlas_tasks_dependency_insights_get
Get dependency-graph insights for a project (critical path, longest chain, top blockers).
- Scope
tasks:read- Calls
- Example prompt
- What are the biggest blockers across Mobile launch?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project id to scope the analytics to. |
Get tasks
Read onlyatlas_tasks_get
Fetch a single task by id.
- Scope
tasks:read- Calls
- Example prompt
- Read me the description of task tsk_a1b2c3.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Import tasks
Changes dataatlas_tasks_import
Bulk-import up to 500 tasks into one project in one call. Returns per-item ok/failed arrays so partial failures do not abort the batch.
- Scope
tasks:write- Calls
- POST /tasks/import
- Example prompt
- Import these 200 backlog tasks from the spreadsheet.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project every imported task is created in. Use atlas_projects_list to find project ids. |
tasks | array of object | Yes | Tasks to import. Per-item failures do not abort the batch. |
Add task labels
Changes dataatlas_tasks_labels_add
Attach an existing label to a task. Idempotent: re-runs return { attached: true|false }.
- Scope
tasks:write- Calls
- POST /tasks/{x}/labels/{x}
- Example prompt
- Add the urgent label to tsk_a1b2c3.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | Yes | Task id. |
labelId | string | Yes | Label id to attach or detach. |
Remove task labels
Destructiveatlas_tasks_labels_remove
Detach a label from a task.
- Scope
tasks:write- Calls
- DELETE /tasks/{x}/labels/{x}
- Example prompt
- Remove the urgent label from tsk_a1b2c3.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | Yes | Task id. |
labelId | string | Yes | Label id to attach or detach. |
List tasks
Read onlyatlas_tasks_list
List tasks in the calling user's tenant. Filter by project or status. Returns up to `limit` rows.
- Scope
tasks:read- Calls
- Example prompt
- Show me every Atlas task tagged P0 that's still open.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | No | Restrict to one project. |
status | string | No | Filter by status (e.g. TODO, IN_PROGRESS, DONE). |
limit | integer | No | Max items to return. |
Get task priority ranking
Read onlyatlas_tasks_priority_ranking_get
Get the priority ranking (ordered list of task ids with scoring rationale) for a project's backlog.
- Scope
tasks:read- Calls
- Example prompt
- Which tasks in Mobile launch should we tackle first?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project id to scope the analytics to. |
Get task progress
Read onlyatlas_tasks_progress_get
Get subtask roll-up progress (counts of done / in_progress / blocked + completion fraction + suggested status).
- Scope
tasks:read- Calls
- Example prompt
- How far along are we on tsk_a1b2c3?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Preview task recurrence
Changes dataatlas_tasks_recurrence_preview
Expand a recurrence rule over a bounded window. Pure preview - no Prisma, no side-effects. Invalid rule returns an empty list.
- Scope
tasks:read- Calls
- POST /tasks/recurring-preview
- Example prompt
- What dates would a weekly Tuesday standup land on this quarter?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
dtstart | string (date-time) | Yes | First occurrence (ISO-8601). |
rule | object | Yes | RRULE-style subset. |
from | string (date-time) | Yes | Window start (ISO-8601). |
to | string (date-time) | Yes | Window end (ISO-8601). |
List task reminders
Read onlyatlas_tasks_reminders_list
List active reminders configured on a task.
- Scope
tasks:read- Calls
- GET /tasks/{x}/reminders
- Example prompt
- What reminders are set on tsk_a1b2c3?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id (e.g. tsk_...). |
Snooze tasks
Changes dataatlas_tasks_snooze
Snooze a task until a specific time, or pass `until: null` to unsnooze. Does not require an If-Match version.
- Scope
tasks:write- Calls
- POST /tasks/{x}/snooze
- Example prompt
- Snooze tsk_a1b2c3 until Monday morning.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id. |
until | string (date-time) | null | Yes | ISO-8601 snooze-until time. Pass null to clear the snooze. |
Apply task templates
Changes dataatlas_tasks_templates_apply
Instantiate a task template into a target project. Returns the new task with template defaults pre-applied.
- Scope
tasks:write- Calls
- POST /task-templates/{x}/apply
- Example prompt
- Apply my Weekly status template to the Mobile launch project.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task template id. |
projectId | string | Yes | Project to create the task in. |
Create task templates
Changes dataatlas_tasks_templates_create
Create a new task template with a default title, optional tags, and priority.
- Scope
tasks:write- Calls
- POST /task-templates
- Example prompt
- Save a template called Weekly status with priority MEDIUM.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Template name. |
defaultTitle | string | Yes | Title applied to instantiated tasks. |
defaultTags | array of string | No | Tag names applied at apply-time. |
defaultPriority | "LOW" | "MEDIUM" | "HIGH" | null | No |
Delete task templates
Destructiveatlas_tasks_templates_delete
Delete a task template the caller owns.
- Scope
tasks:delete- Calls
- DELETE /task-templates/{x}
- Example prompt
- Delete the Weekly status template - I don't use it anymore.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task template id. |
List task templates
Read onlyatlas_tasks_templates_list
List the caller's saved task templates (per-user roster of task starting points), one page at a time; pass the nextCursor of a page as cursor to read the next one.
- Scope
tasks:read- Calls
- GET /task-templates
- Example prompt
- What task templates do I have saved?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many rows to return, 1 to 100. 50 by default. |
cursor | string | No | The nextCursor of the previous page. Leave it out for the first page. |
sort | "createdAt" | "updatedAt" | "name" | No | The field to sort on: createdAt, updatedAt, name. createdAt by default. |
order | "asc" | "desc" | No | asc or desc. desc by default. |
Transition tasks
Changes dataatlas_tasks_transition
Move a task through a workflow transition (id-based). Pass expectedVersion for optimistic concurrency.
- Scope
tasks:write- Calls
- POST /tasks/{x}/transition
- Example prompt
- Move tsk_a1b2c3 from In review to Done via transition tr_pass.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id. |
transitionId | string | Yes | Workflow transition id. |
comment | string | No | |
expectedVersion | integer | No | Expected current task version (optimistic concurrency). |
Get task types
Read onlyatlas_tasks_types_get
Fetch one global task type by stable key from the tenant-wide task type catalog. Read-only and tenant-scoped.
- Scope
tasks:read- Calls
- Example prompt
- Show me the global story task type definition.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
key | string | Yes |
List task types
Read onlyatlas_tasks_types_list
List the global task type catalog for the tenant, including system task-type records available as project defaults.
- Scope
tasks:read- Calls
- Example prompt
- Which task types are available globally in Atlas?
Arguments
This tool takes no arguments.
Update tasks
Changes dataatlas_tasks_update
Update fields on an existing task. Pass `ifMatchVersion` to use optimistic concurrency.
- Scope
tasks:write- Calls
- Example prompt
- Bump the deadline on tsk_a1b2c3 to next Monday.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Task id. |
title | string | No | |
description | string | No | |
priority | "NONE" | "LOW" | "MEDIUM" | "HIGH" | "URGENT" | No | |
status | string | No | |
dueOn | string (date-time) | null | No | |
startsOn | string (date-time) | null | No | |
estimateMin | integer | null | No | |
ifMatchVersion | integer | No | Pass the task version you last saw. The server returns 409 if the task changed in between. |