AtlasWork, planned itself.

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

    System status
    • SSO
    • SCIM
    • Two-factor sign-in
    • Audit log

    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

    You are in control of your cookies

    Atlas uses strictly necessary cookies to keep you signed in. With your consent, we add anonymized product analytics, conversion attribution, and remembered preferences. Change your mind any time at /privacy/cookies.

    Off until you agree · Change it any time

    • Necessaryalways on
    • Analyticsopt-in
    • Marketingopt-in
    • Preferencesopt-in
    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
    • Signing in and security
    • Client portal

    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 is 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, one page at a time. Filter by project or status. Returns `{ items, nextCursor }`; pass `nextCursor` back as `cursor` for the next page.

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

    Arguments

    FieldTypeRequiredDescription
    projectIdstringNoRestrict to one project.
    statusstringNoFilter by status (e.g. TODO, IN_PROGRESS, DONE).
    limitintegerNoHow many tasks to return, 1 to 100.
    cursorstringNoThe nextCursor of the previous page. Leave it out for the first page.

    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 do not 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.