Diagrams

atlas_diagrams_access_list

List a diagram's doc-level access grants (principalUserId + role: VIEW/COMMENT/EDIT/RESTRICTED_VIEWER). The implicit owner grant is not listed.

Scope

diagrams:read

Calls

GET /diagrams/{x}/access

Example prompt

Who has access to the payments diagram?

Arguments

atlas_diagrams_access_revoke

Revoke ONE principal's doc-level access to a diagram (un-share). Idempotent - a no-op if the principal had no grant. Requires the diagram owner or a workspace admin.

Scope

diagrams:write

Calls

DELETE /diagrams/{x}/access/{x}

Example prompt

Remove access to the payments diagram for Priya.

Arguments

atlas_diagrams_access_set

Grant or update ONE principal's doc-level role on a diagram (upserts by principalUserId). Requires the diagram owner or a workspace admin. RESTRICTED_VIEWER may view but not copy/export/print/render.

Scope

diagrams:write

Calls

POST /diagrams/{x}/access

Example prompt

Give Priya edit access to the payments diagram.

Arguments

atlas_diagrams_ai_edits_apply

Apply a natural-language edit to an existing diagram document. Returns { result: { ops, message, model, validatorOutcome }, progress[] } - ops are the mutation ops to apply to the doc. Pass selection to scope the edit to specific nodes.

Scope

diagrams:write

Calls

POST /diagrams/ai/edit

Example prompt

Add a retry step after the payment node.

Arguments

atlas_diagrams_archive

Archive a diagram (removed from both the active library and Trash; kept, not destroyed). Requires EDIT access.

Scope

diagrams:write

Calls

POST /diagrams/{x}/archive

Example prompt

Archive the 2025 migration diagram.

Arguments

atlas_diagrams_bindings_delete

Remove a shape->entity binding from a diagram. Returns 204 No Content.

Scope

diagrams:delete

Calls

DELETE /diagrams/{id}/bindings/{bindingId}

Example prompt

Unbind that node from the Northwind project.

Arguments

atlas_diagrams_bindings_list

List every shape->entity data binding on a diagram (nodeId, entityType, entityId, fieldMap).

Scope

diagrams:read

Calls

GET /diagrams/{id}/bindings

Example prompt

Which shapes on this diagram are bound to Atlas records?

Arguments

atlas_diagrams_bindings_resolve

Resolve live field values for every binding on a diagram by reading the referenced Atlas records through their owning services (within-tenant record authz honored). Returns resolved values + a weak etag; records the caller cannot see come back visible:false.

Scope

diagrams:read

Calls

GET /diagrams/{id}/bindings/resolve

Example prompt

Refresh the live data on the portfolio diagram.

Arguments

atlas_diagrams_bindings_set

Bind a diagram shape (by nodeId) to an Atlas record (Task/Project/CRM/Employee/Goal/Portfolio) so its label/badge reflect live data. Upserts by (diagram, nodeId).

Scope

diagrams:write

Calls

POST /diagrams/{id}/bindings

Example prompt

Bind this node to the Northwind project.

Arguments

atlas_diagrams_code_convert

Build a diagram from source code or schema text (SQL DDL, Prisma, TypeScript, etc.). Auto-detects ERD vs flow unless kind is given. Returns { graph, mermaid, doc, strategy, model, validatorOutcome }.

Scope

diagrams:write

Calls

POST /diagrams/ai/from-code

Example prompt

Build an entity diagram from this schema file.

Arguments

atlas_diagrams_comments_create

Add a comment to a diagram, optionally pinned to a canvas anchor (node id / x,y).

Scope

diagrams:write

Calls

POST /diagrams/{id}/comments

Example prompt

Comment on the gateway node that it needs a retry path.

Arguments

atlas_diagrams_comments_delete

Delete a comment from a diagram. Returns 204 No Content.

Scope

diagrams:delete

Calls

DELETE /diagrams/{id}/comments/{commentId}

Example prompt

Delete my comment on the payments diagram.

Arguments

atlas_diagrams_comments_list

List the comment threads on a diagram (body, author, anchor, resolved state).

Scope

diagrams:read

Calls

GET /diagrams/{id}/comments

Example prompt

What comments are on the payments diagram?

Arguments

atlas_diagrams_comments_update

Edit a comment body and/or toggle its resolved state.

Scope

diagrams:write

Calls

PATCH /diagrams/{id}/comments/{commentId}

Example prompt

Mark that diagram comment resolved.

Arguments

atlas_diagrams_create

Create a new diagram. Defaults to a structured flowchart with an empty document; pass documentJson or dslSource to seed content and visibility (PRIVATE/SHARED/ORG). Idempotent per call.

Scope

diagrams:write

Calls

POST /diagrams

Example prompt

Create a flowchart called Order Fulfilment.

Arguments

atlas_diagrams_delete

Delete (soft-delete) a diagram. It moves to Trash (recoverable for 30 days). Returns 204 No Content on success.

Scope

diagrams:delete

Calls

DELETE /diagrams/{x}

Example prompt

Move the old onboarding diagram to Trash.

Arguments

atlas_diagrams_erds_generate

Generate an ERD from the Atlas data model. Optionally pass `models` to narrow to a subset (case-insensitive). Always-current because Atlas owns the schema. Returns the laid-out doc; nothing is persisted.

Scope

diagrams:read

Calls

POST /diagrams/generate/erd-from-schema

Example prompt

Draw an entity diagram of the task and project models.

Arguments

atlas_diagrams_export

Render a diagram to a text format and return the bytes as text: svg, mermaid, json, or drawio. For png/pdf (binary) call POST /diagrams/:id/export directly.

Scope

diagrams:read

Calls

POST /diagrams/{x}/export

Example prompt

Export the payments diagram as SVG.

Arguments

atlas_diagrams_folders_create

Create a diagram folder, optionally nested under a parent folder.

Scope

diagrams:write

Calls

POST /diagrams/folders

Example prompt

Create a diagram folder called Architecture.

Arguments

atlas_diagrams_folders_list

List the diagram folders (tree) in the caller's tenant.

Scope

diagrams:read

Calls

GET /diagrams/folders/list

Example prompt

What diagram folders do we have?

Arguments

This tool takes no arguments.

atlas_diagrams_generate

Generate a diagram from a natural-language description (NL->diagram). Returns { result: { graph, mermaid, doc, model, validatorOutcome }, progress[] }. Pass diagramId to write the result into an existing diagram.

Scope

diagrams:write

Calls

POST /diagrams/ai/generate

Example prompt

Draw the checkout flow from this description.

Arguments

atlas_diagrams_get

Fetch one diagram by id: title, kind, engine, documentJson, dslSource, rules, version, and counts.

Scope

diagrams:read

Calls

GET /diagrams/{x}

Example prompt

Open the payments architecture diagram.

Arguments

atlas_diagrams_images_convert

Vectorize a photo/screenshot of a diagram (base64) into an editable Atlas diagram. Returns { graph, mermaid, doc, model, validatorOutcome }.

Scope

diagrams:write

Calls

POST /diagrams/ai/from-image

Example prompt

Turn this whiteboard photo into an editable diagram.

Arguments

atlas_diagrams_list

List Diagram Studio diagrams in the caller's tenant. Filter by owner, folder, kind, a title query, or a sharing scope (mine/shared/all); cursor-paginated (max 100/page).

Scope

diagrams:read

Calls

GET /diagrams

Example prompt

List the diagrams shared with me.

Arguments

atlas_diagrams_org_charts_generate

Generate the tenant's LIVE org chart from Atlas HR (read through HrCore so within-tenant authz is honored). Optionally narrow to one manager's subtree via rootEmployeeId. Each node carries a binding descriptor for live data-links. Returns the laid-out doc; nothing is persisted.

Scope

diagrams:read

Calls

POST /diagrams/generate/org-chart

Example prompt

Generate our live org chart under the engineering director.

Arguments

atlas_diagrams_restore

Restore a soft-deleted diagram from Trash back into the active library (undo of atlas_diagrams_delete). Requires EDIT access.

Scope

diagrams:write

Calls

POST /diagrams/{x}/restore

Example prompt

Restore the onboarding diagram from Trash.

Arguments

atlas_diagrams_rules_get

Read a diagram's conditional-formatting rules (evaluated client-side against resolved binding values).

Scope

diagrams:read

Calls

GET /diagrams/{id}/rules

Example prompt

What conditional formatting rules does this diagram use?

Arguments

atlas_diagrams_rules_set

Replace a diagram's ordered conditional-formatting rule set. Each rule: when a resolved field satisfies a predicate (eq/ne/gt/gte/lt/lte/contains/exists/empty), apply a style patch (fill/stroke/textColor/badge).

Scope

diagrams:write

Calls

PUT /diagrams/{id}/rules

Example prompt

Colour any node red when its project is off track.

Arguments

atlas_diagrams_search

Semantic (embedding) search over this tenant's diagrams by meaning, not just title. Returns { hits } ranked by similarity.

Scope

diagrams:read

Calls

POST /diagrams/ai/search

Example prompt

Find our diagrams about refund handling.

Arguments

atlas_diagrams_shape_categories_list

List shape-library categories with their counts.

Scope

diagrams:read

Calls

GET /diagrams/shapes/categories

Example prompt

What shape categories are in the library?

Arguments

This tool takes no arguments.

atlas_diagrams_shapes_create

Save a tenant-owned custom shape ("save as component") from inert <svg> markup.

Scope

diagrams:write

Calls

POST /diagrams/shapes

Example prompt

Save this SVG as a reusable company shape.

Arguments

atlas_diagrams_shapes_delete

Delete a tenant-owned custom shape. Returns 204 No Content. Built-in catalog shapes cannot be deleted.

Scope

diagrams:delete

Calls

DELETE /diagrams/shapes/{id}

Example prompt

Delete our custom gateway shape.

Arguments

atlas_diagrams_shapes_search

Keyword/synonym/fuzzy search over the global shape+icon catalog (~206k stencils across the icon packs) plus this tenant's custom shapes. Narrow by `category` or coarse `pack`. Empty query returns a category-ordered default gallery.

Scope

diagrams:read

Calls

GET /diagrams/shapes

Example prompt

Find gateway shapes I can drop on the canvas.

Arguments

atlas_diagrams_share_links_create

Mint a public, read-only (or comment-scoped) share link for a diagram and return the token PLUS its credential-free public artifact paths: an SVG (vector) and PNG (raster) image render, an oEmbed discovery doc, and a read-only JSON snapshot. Use this instead of atlas_diagrams_slack_share when you just need a link/image/embed without posting to Slack. The token is shown ONCE. Requires EDIT access.

Scope

diagrams:write

Calls

POST /diagrams/{id}/share-links

Example prompt

Create a read-only link to the payments diagram.

Arguments

atlas_diagrams_share_links_list

List a diagram's active public share links (id, scope, expiry, access count, whether a password is set). Token hashes are never returned - the raw token is only shown once at creation.

Scope

diagrams:read

Calls

GET /diagrams/{id}/share-links

Example prompt

Which share links are active on the payments diagram?

Arguments

atlas_diagrams_share_links_revoke

Revoke a public share link by id (idempotent). The link and all its public render/embed paths stop resolving. Requires EDIT access.

Scope

diagrams:delete

Calls

DELETE /diagrams/{id}/share-links/{linkId}

Example prompt

Revoke the public link to the payments diagram.

Arguments

atlas_diagrams_slack_share

Publish a diagram to a public read-only link and post it to Slack (title + preview image + link). Requires EDIT access. If Slack is not connected it still returns the public link/render/oEmbed URLs (posted:false) so you can paste the link and let Slack unfurl it.

Scope

diagrams:write

Calls

POST /diagrams/{id}/share-to-slack

Example prompt

Post the payments diagram to the architecture Slack channel.

Arguments

atlas_diagrams_summarize

Produce a natural-language explanation of a diagram document: a one-liner, a step-by-step walkthrough, and a long description. Returns { oneLiner, walkthrough, longDescription, model }.

Scope

diagrams:read

Calls

POST /diagrams/ai/explain

Example prompt

Explain the payments diagram step by step.

Arguments

atlas_diagrams_tables_convert

Generate a laid-out diagram doc from tabular data (org chart, ERD, or flow). Provide `rows` (parsed objects) or a `csv` string; optionally a `mapping` of logical fields to your column headers. Read-only derivation - nothing is persisted; returns the doc ready to open or write into a diagram.

Scope

diagrams:read

Calls

POST /diagrams/generate/from-table

Example prompt

Turn this CSV of reporting lines into an org chart.

Arguments

atlas_diagrams_templates_apply

Instantiate a template (built-in or tenant) into a brand-new diagram. Returns the new diagram.

Scope

diagrams:write

Calls

POST /diagrams/from-template/{x}

Example prompt

Start a new diagram from the incident response template.

Arguments

atlas_diagrams_templates_create

Save a reusable tenant template, either by snapshotting an existing diagram (diagramId) or from an inline documentJson.

Scope

diagrams:write

Calls

POST /diagrams/templates

Example prompt

Save the payments diagram as a reusable template.

Arguments

atlas_diagrams_templates_list

List the built-in template gallery plus this tenant's own templates, optionally narrowed to one category.

Scope

diagrams:read

Calls

GET /diagrams/templates

Example prompt

Which diagram templates are available?

Arguments

atlas_diagrams_trash_delete

Permanently delete a diagram and all its dependents ("delete forever" from Trash). Irreversible. Returns 204 No Content. Requires DELETE access.

Scope

diagrams:delete

Calls

DELETE /diagrams/{x}/purge

Example prompt

Delete the scratch diagram forever.

Arguments

atlas_diagrams_trash_list

List this tenant's soft-deleted diagrams (the Trash tab). Each stays recoverable for 30 days before it is eligible for permanent deletion.

Scope

diagrams:read

Calls

GET /diagrams/trash

Example prompt

What is in the diagram Trash?

Arguments

This tool takes no arguments.

atlas_diagrams_update

Patch a diagram (title, kind, engine, documentJson, dslSource, folder, workspace, visibility). Pass ifMatchVersion for optimistic concurrency; content changes auto-snapshot a revision and refresh the thumbnail. Changing visibility requires owner/admin.

Scope

diagrams:write

Calls

PATCH /diagrams/{x}

Example prompt

Rename the payments diagram to Payments v2.

Arguments

atlas_diagrams_versions_list

List the auto-snapshotted revision history of a diagram (version, author, reason, timestamp).

Scope

diagrams:read

Calls

GET /diagrams/{x}/versions

Example prompt

Show the version history of the payments diagram.

Arguments

atlas_diagrams_versions_restore

Restore a diagram to a prior version snapshot. Returns the updated diagram.

Scope

diagrams:write

Calls

POST /diagrams/{id}/versions/{versionId}/restore

Example prompt

Roll the payments diagram back to version 4.

Arguments

atlas_diagrams_visibility_set

Set a diagram's coarse sharing visibility (PRIVATE / SHARED / ORG). Convenience wrapper over PATCH /diagrams/:id - widening visibility requires the owner or a workspace admin.

Scope

diagrams:write

Calls

PATCH /diagrams/{x}

Example prompt

Make the payments diagram visible to the whole organisation.

Arguments