AtlasWork, planned itself.

The AI-native, all-in-one work platform. Tasks, projects, CRM, contracts, and analytics in one calm workspace.

All systems operational
  • SOC 2 II
  • ISO 27001
  • HIPAA
  • GDPR

Product

  • Overview
  • PDF tools
  • Diagram tools
  • People & HR
  • Integrations
  • Marketplace
  • Pricing

Resources

  • Guides
  • Glossary
  • Compare
  • Docs
  • API reference
  • Support
  • Changelog
  • Status

Company

  • About
  • Careers
  • Press
  • Contact

Legal & trust

  • Trust center
  • Security
  • Privacy
  • Terms
  • DPA
  • GDPR
  • SLA
  • Refunds
  • Google API data
Atlas, a product by wrxstack.com·© 2026 wrxstack·All rights reserved
PrivacyTermsSecurityStatus
Skip to documentation
Docs
Back to Atlas

Start here

  • Overview

Developer

  • REST API guide
  • Authentication
  • API reference
  • MCP (AI agents)
  • MCP tools reference
  • SDKs
  • Quick actions
  • Changelog

Webhooks

  • Overview
  • Quickstart
  • Events
  • Payloads and headers
  • Security and signing
  • Delivery and retries
  • Managing via API

Connect

  • Connectors
  • Integrations

Product

  • Collaboration and chat

Reference

  • Glossary
  • Keyboard shortcuts
  • Module reference

Tools reference

Tasks

Every Tasks tool, with the scope it needs, its arguments and the API operation it calls.

All areasTasksProjectsPortfoliosBoardsGoalsHabitsCommentsTime trackingWorkloadCRMGrowth suiteContractseSignPDF StudioFormsCalendarBookingMeetingsChatHuddlesWikiDocumentationDiagramsWhiteboardsHRPayrollClient deliveryClient onboardingService operationsStatus pageAutomationsAgentsAIReportsInsightsConnectorsNotificationsSearchWorkspace administrationAccessGovernancePrivacyBillingWebhooksAccess tokensMy accountFocusChangelogBlogTrashThemesEmail templatesMetadataCustom fieldsWalkthroughsVoiceActivityServer

30 tools

Archive tasks

Destructive

atlas_tasks_archive

Archive (soft-delete) a task. Reversible via the web UI.

Scope
tasks:delete
Calls
DELETE /v1/tasks/{id}
Example prompt
Archive tsk_a1b2c3 - we shipped this last quarter.

Arguments

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Preview task auto schedule

Changes data

atlas_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
POST /tasks/auto-schedule/what-if-preview
Example prompt
What would the schedule look like if we cap to 5 moves per day?

Arguments

FieldTypeRequiredDescription
taskIdsarray of stringNo
horizonDaysintegerNo
guardrailsobjectNo

Run task auto schedule

Changes data

atlas_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

FieldTypeRequiredDescription
taskIdsarray of stringNoRestrict to specific tasks. Omit to schedule everything in the user backlog.
horizonDaysintegerNoHow many days forward to schedule.
dryRunbooleanNoWhen true, returns the planned moves without persisting.

Get task board

Read only

atlas_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

FieldTypeRequiredDescription
boardIdstringYesBoard id (e.g. brd_...).
limitPerColumnintegerNoPer-column page size.

Create tasks in bulk

Changes data

atlas_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
POST /v1/bulk/tasks
Example prompt
Create these 50 onboarding tasks for the new hire in one call.

Arguments

FieldTypeRequiredDescription
itemsarray of objectYesUp 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 data

atlas_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
POST /v1/bulk/tasks
Example prompt
Move every overdue Q3 task to the Q4 milestone in one shot.

Arguments

FieldTypeRequiredDescription
itemsarray of objectYesUp to 200 task updates in one request. Each item carries its own ifMatchVersion when optimistic concurrency is needed.

Complete tasks

Changes data

atlas_tasks_complete

Convenience: mark a task as DONE.

Scope
tasks:write
Calls
PATCH /v1/tasks/{id}
Example prompt
Mark tsk_a1b2c3 as done.

Arguments

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Create tasks

Changes data

atlas_tasks_create

Create a new task. Idempotent: re-runs within 24h return the same task.

Scope
tasks:write
Calls
POST /v1/tasks
Example prompt
Add a task: review the Q3 forecast, due Friday, in the Atlas project.

Arguments

FieldTypeRequiredDescription
projectIdstringYesProject to create the task in.
titlestringYesShort, human-readable title.
descriptionstringNoOptional long-form body. Markdown supported.
priority"NONE" | "LOW" | "MEDIUM" | "HIGH" | "URGENT"NoImportance ranking.
dueOnstring (date-time)NoISO-8601 deadline.
startsOnstring (date-time)NoISO-8601 start date.
statusstringNoInitial status. Defaults to the project default.
assigneeIdstringNoUser id of the single workspace member to assign. A task takes one assignee on creation.
labelIdsarray of stringNoLabel ids to apply.
estimateMinintegerNoEstimate in minutes.

Add task dependencies

Changes data

atlas_tasks_dependencies_add

Add a dependency edge between two tasks (default kind: BLOCKS).

Scope
tasks:write
Calls
POST /v1/tasks/{id}/dependencies
Example prompt
Make tsk_a1b2c3 block tsk_zzz.

Arguments

FieldTypeRequiredDescription
fromTaskIdstringYesTask that owns the dependency edge.
toTaskIdstringYesTask on the other end.
kind"BLOCKS" | "DUPLICATES" | "RELATES"NoEdge kind.

List task dependencies

Read only

atlas_tasks_dependencies_list

List blockers + blocking + relates edges for a task.

Scope
tasks:read
Calls
GET /v1/tasks/{id}/dependencies
Example prompt
What's blocking task tsk_a1b2c3?

Arguments

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Remove task dependencies

Destructive

atlas_tasks_dependencies_remove

Remove a dependency edge between two tasks.

Scope
tasks:write
Calls
DELETE /v1/tasks/{id}/dependencies/{toTaskId}
Example prompt
Remove the block from tsk_a1b2c3 to tsk_zzz.

Arguments

FieldTypeRequiredDescription
fromTaskIdstringYes
toTaskIdstringYes

Get task dependency insights

Read only

atlas_tasks_dependency_insights_get

Get dependency-graph insights for a project (critical path, longest chain, top blockers).

Scope
tasks:read
Calls
GET /tasks/dependency-insights
Example prompt
What are the biggest blockers across Mobile launch?

Arguments

FieldTypeRequiredDescription
projectIdstringYesProject id to scope the analytics to.

Get tasks

Read only

atlas_tasks_get

Fetch a single task by id.

Scope
tasks:read
Calls
GET /v1/tasks/{id}
Example prompt
Read me the description of task tsk_a1b2c3.

Arguments

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Import tasks

Changes data

atlas_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

FieldTypeRequiredDescription
projectIdstringYesProject every imported task is created in. Use atlas_projects_list to find project ids.
tasksarray of objectYesTasks to import. Per-item failures do not abort the batch.

Add task labels

Changes data

atlas_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

FieldTypeRequiredDescription
taskIdstringYesTask id.
labelIdstringYesLabel id to attach or detach.

Remove task labels

Destructive

atlas_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

FieldTypeRequiredDescription
taskIdstringYesTask id.
labelIdstringYesLabel id to attach or detach.

List tasks

Read only

atlas_tasks_list

List tasks in the calling user's tenant. Filter by project or status. Returns up to `limit` rows.

Scope
tasks:read
Calls
GET /v1/tasks
Example prompt
Show me every Atlas task tagged P0 that's still open.

Arguments

FieldTypeRequiredDescription
projectIdstringNoRestrict to one project.
statusstringNoFilter by status (e.g. TODO, IN_PROGRESS, DONE).
limitintegerNoMax items to return.

Get task priority ranking

Read only

atlas_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
GET /tasks/priority-ranking
Example prompt
Which tasks in Mobile launch should we tackle first?

Arguments

FieldTypeRequiredDescription
projectIdstringYesProject id to scope the analytics to.

Get task progress

Read only

atlas_tasks_progress_get

Get subtask roll-up progress (counts of done / in_progress / blocked + completion fraction + suggested status).

Scope
tasks:read
Calls
GET /tasks/{id}/progress
Example prompt
How far along are we on tsk_a1b2c3?

Arguments

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Preview task recurrence

Changes data

atlas_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

FieldTypeRequiredDescription
dtstartstring (date-time)YesFirst occurrence (ISO-8601).
ruleobjectYesRRULE-style subset.
fromstring (date-time)YesWindow start (ISO-8601).
tostring (date-time)YesWindow end (ISO-8601).

List task reminders

Read only

atlas_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

FieldTypeRequiredDescription
idstringYesTask id (e.g. tsk_...).

Snooze tasks

Changes data

atlas_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

FieldTypeRequiredDescription
idstringYesTask id.
untilstring (date-time) | nullYesISO-8601 snooze-until time. Pass null to clear the snooze.

Apply task templates

Changes data

atlas_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

FieldTypeRequiredDescription
idstringYesTask template id.
projectIdstringYesProject to create the task in.

Create task templates

Changes data

atlas_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

FieldTypeRequiredDescription
namestringYesTemplate name.
defaultTitlestringYesTitle applied to instantiated tasks.
defaultTagsarray of stringNoTag names applied at apply-time.
defaultPriority"LOW" | "MEDIUM" | "HIGH" | nullNo

Delete task templates

Destructive

atlas_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

FieldTypeRequiredDescription
idstringYesTask template id.

List task templates

Read only

atlas_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

FieldTypeRequiredDescription
limitintegerNoHow many rows to return, 1 to 100. 50 by default.
cursorstringNoThe nextCursor of the previous page. Leave it out for the first page.
sort"createdAt" | "updatedAt" | "name"NoThe field to sort on: createdAt, updatedAt, name. createdAt by default.
order"asc" | "desc"Noasc or desc. desc by default.

Transition tasks

Changes data

atlas_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

FieldTypeRequiredDescription
idstringYesTask id.
transitionIdstringYesWorkflow transition id.
commentstringNo
expectedVersionintegerNoExpected current task version (optimistic concurrency).

Get task types

Read only

atlas_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
GET /v1/task-types/{key}
Example prompt
Show me the global story task type definition.

Arguments

FieldTypeRequiredDescription
keystringYes

List task types

Read only

atlas_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
GET /v1/task-types
Example prompt
Which task types are available globally in Atlas?

Arguments

This tool takes no arguments.

Update tasks

Changes data

atlas_tasks_update

Update fields on an existing task. Pass `ifMatchVersion` to use optimistic concurrency.

Scope
tasks:write
Calls
PATCH /v1/tasks/{id}
Example prompt
Bump the deadline on tsk_a1b2c3 to next Monday.

Arguments

FieldTypeRequiredDescription
idstringYesTask id.
titlestringNo
descriptionstringNo
priority"NONE" | "LOW" | "MEDIUM" | "HIGH" | "URGENT"No
statusstringNo
dueOnstring (date-time) | nullNo
startsOnstring (date-time) | nullNo
estimateMininteger | nullNo
ifMatchVersionintegerNoPass the task version you last saw. The server returns 409 if the task changed in between.