Skip to content
ClaudeListedTier: partner

Ambiguous

Part ofAmbiguousMCP server

The workspace built for human-AI collaboration. 17 productivity apps reimagined so work flows between your team and agents.

First seen 13 Nov 2026. Evidence as of 16 Nov 2026.

914
Tools
From an anonymous probe
2
Source listings
Each with its own history
50
Recorded changes
Since first seen

Tools

ToolDescriptionBehaviour
ack_mentions_activityAcknowledge the Mentions & reactions inbox after it has been displayed. Marks the caller's unread chat mention notifications read and stamps users.mentions_acked_at, so the projector recomputes both chat.mentions and chat.reactions to 0 durably (the sidebar "Mentions & reactions" item un-bolds and stays cleared across re-fetch). Per-channel read cursors are untouched, so channel message unread counts are unaffected; a reaction that arrives after the ack re-bolds the item.Changes data
ack_thread_activityAcknowledge readable Threads inbox activity on entry without advancing personal read cursors or clearing explicit manual unread intent.Changes data
activate_document_logical_ownershipPrepare compatible readers and activate source-preserving paragraph structure editing on a generation-zero document. Requires edit permission, a current content hash and state vector, and a completed reader fence. Pending fence returns its ready-after deadline without activating the model.Changes data
add_conditional_formatAdd a conditional formatting rule to a spreadsheet. Provide one of booleanRule, gradientRule, iconSetRule, or dataBarRule. The server generates a unique ID for the rule.Changes data
add_connected_elementUse to extend a flowchart/map/swimlane: source_element_id and direction n/s/e/w place a new node one standard gap away, clear overlaps, and create its attached connector. Optional drop_point {x, y} centers the node there instead. element sets its type; omit to duplicate source. Connector/frame/swimlane types refused; portal source returns 400 portal_not_connectable. Coordinates: board units, top-left origin, +x right/+y down. Example: add_connected_element({id:"<boardId>", source_element_id:"<elId>", direction:"e", element:{type:"shape", shape:"diamond"}}) returns element and connector.Changes data
add_deal_line_itemAdd a line item to a deal. Either reference an existing product (via product_id) or create a custom line by providing name and unit_price. The deal amount is auto-recalculated.Changes data
add_pipeline_memberAdd (or update the role of) a user or team on a CRM pipeline. Provide either user_id or team_id, plus role (admin | member). Admins/owners and pipeline admins can manage members.Changes data
add_shared_drive_memberAdd a member (manager-only).Changes data
add_sheet_columnAdd a column to a sheet tab.Changes data
add_sheet_rowsAppend rows to a sheet tab. Each row is an object keyed by column ID. Example: [{"A": "Widget", "B": 9.99}]. The response carries `history`, a receipt for `restore-structure` undo and redo.Changes data
add_sheet_tabAdd a new tab to a sheet. Auto-generates the name if not provided.Changes data
add_slideUse to add a JSON slide with layout/background/elements. Each typed text/image/shape/table/video/group has x, y, w, h and type fields. Give EACH title/bullet/paragraph its own positioned text element, never multiple lines/bullets together. Use • bullets, not Markdown * or -. Set fontSize/fontWeight hierarchy. If viewing a presentation, use its ID from page context.Changes data
add_task_attachmentCopy a Drive file you can view into a task-owned attachment. The original remains independent. Re-attaching the same source returns the active attachment; a stable idempotency_key prevents replay after removal. A native doc, sheet, deck, canvas or form without stored bytes returns 422 native_document_not_copyable; attach it as a link.Changes data
add_team_memberAdd a user to a team with an optional role (admin or member). Only team admins or workspace admins can add members. Default role is 'member'. Use this when the user asks to add someone to a team or distribution list.Changes data
admin_integration_deletedisconnect an integrationDestructive
admin_integration_updateupdate integration configChanges data
admin_integrations_listlist all integrations for workspaceRead-only
admin_integrations_slack_channelslist Slack channels via bot tokenRead-only
admin_invites_listList pending, accepted, and expired workspace invites, pending first and then newest. Paginated; `pending_total` counts invites awaiting acceptance. Each row also carries `delivery` — what the provider said about the latest send of that invite email, so a bounced invite is distinguishable from an ignored one.Read-only
admin_mail_suppression_createmanually add a suppressionChanges data
admin_mail_suppression_deleteClear a bounce once the address is fixed. An unsubscribe or spam complaint is lifted only by the recipient, so clearing one is refused with 409 suppression_recipient_controlled; clearing a bounce on an address that also unsubscribed keeps the unsubscribe.Destructive
admin_mail_suppressions_listlist suppressed addressesRead-only
admin_notification_defaults_getRead workspace-default email notification prefs. Returns sensible defaults (all enabled) when never configured.Read-only
admin_notification_defaults_updatePartially update workspace-default email notification prefs. Emits settings.updated audit event.Changes data
admin_usage_exportExport usage stats as CSVRead-only
admin_usage_timeseriesDaily creation counts (last 14 days, split into "last 7" + "prior 7" windows) for the four hero metrics on the Overview tab. Returns `{users, documents, messages, emails}` each with `{buckets[7], total, previous_total}` so the UI can draw a sparkline + render a 7...Read-only
admin_user_getGet one workspace user's full admin record by id.Read-only
admin_user_reset_passwordEmail the member a one-hour password-reset link. When the send fails, `sent` is false with `error: "delivery_failed"`. The link itself is returned only to a REST caller, never to an AI tool surface.Destructive
admin_workspace_logo_deleteRemove workspace logo (admin only)Destructive
agent_get_email_accessRead an agent's email scope, approved contacts, record version, the human who reviews its held emails, and whether the calling principal may change it. Readable by workspace humans with standing access, existing management readers, and the agent itself; `can_manage` is false for the agent's own read.Read-only
agent_list_connectionsList every live API key acting as the caller or as an agent the caller manages, classified by how it connects: `connector` (a chat app approved through OAuth), `terminal` (a terminal tool set up from a setup message) or `api_key`. An admin or owner additionally sees every agent's keys; another member's own keys never appear. `setting_up` is true while a terminal tool has not yet redeemed its setup message.Read-only
agent_set_email_accessSet an agent's email scope. A human manager or human workspace admin/owner only — an agent cannot widen its own delegation even holding the admin role, and no profile or config update can write this field.Changes data
analytics_annotations_listList a project's annotations, oldest date first: each is a date, an optional end date, a short text and its author, drawn on every time-series chart in the project. `from`/`to` keep only annotations overlapping that range.Read-only
analytics_catalog_overrides_listList catalog metadata overrides for the workspace.Read-only
analytics_catalog_statsPer-event last_seen_at and 30-day volume for the workspace's tracked events.Read-only
analytics_cohorts_createCreate a saved cohort definition.Changes data
analytics_cohorts_getRead a saved cohort's name, stored criteria and member-count snapshot by ID, without recomputing its audience. Use analytics_cohorts_list to find cohort IDs. Requires a role on the report's project; `404` otherwise.Read-only
analytics_cohorts_listList saved cohort reports in the active workspace, including their definitions and stored member counts. Lists one Analytics project (`project_id`) and requires a role on it.Read-only
analytics_cohorts_updateUpdate a saved cohort definition.Changes data
analytics_dashboards_createCreate a new analytics dashboard.Changes data
analytics_dashboards_getRead a saved analytics dashboard's name, stored query and tile layout by ID. Requires a role on the dashboard's project; unavailable dashboards return not found. Use analytics_dashboards_list to find accessible IDs. Requires a role on the report's project; `404` otherwise.Read-only
analytics_dashboards_listList the saved analytics dashboards of one Analytics project (`project_id`), including their tile layouts. Everyone who can view the project sees every dashboard in it. Requires a role on the report's project; `404` otherwise.Read-only
analytics_dashboards_updateUpdate an analytics dashboard's name, dashboard query or tile layout; omitted fields are kept. Requires editor on the dashboard's project: a viewer gets 403, and a caller with no role gets 404. Every report tile must come from the same project (`400 project_mismatch`).Changes data
analytics_debuggerUnified live debugger — interleaved ingest successes and errors, cursor-paginated, tenant-isolated via writeKey ownership.Read-only
analytics_events_getRead one Analytics evidence event owned by the caller's source workspace. Foreign and missing IDs return 404.Read-only
analytics_events_listList source-owned Analytics evidence with bounded filters and stable pagination. Measured group IDs never grant access.Read-only
analytics_funnels_createCreate a saved funnel report.Changes data
analytics_funnels_getRead a saved funnel report's name and stored conversion query definition by ID, without running the funnel. Use analytics_funnels_list to find report IDs. Requires a role on the report's project; `404` otherwise.Read-only
analytics_funnels_listList saved funnel reports in the active workspace, including their names and conversion query definitions. Lists one Analytics project (`project_id`) and requires a role on it.Read-only
analytics_funnels_updateUpdate a saved funnel report.Changes data
analytics_insights_createCreate a saved insights report.Changes data
analytics_insights_getRead a saved insights report's name and stored query definition by ID, without executing the query. Use analytics_insights_list to find report IDs. Requires a role on the report's project; `404` otherwise.Read-only
analytics_insights_listList saved insights reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.Read-only
analytics_insights_updateUpdate a saved insights report.Changes data
analytics_metric_definitions_listList metric definitions visible in the named Analytics project, or its workspace default when omitted. management=true instead reads the workspace-wide admin catalog. Each definition includes its newest stored period.Read-only
analytics_metric_valueRead one number from a saved insight or funnel over a window: the value, the same metric over the window before it, a sparkline and a link to the report. Embedded metrics on canvas, in chips and in sheets read through this. Example: report=insights:<id>&from=today-28d&to=now.Read-only
analytics_metrics_upsertUpsert external metric rows (ad spend, cloud spend, incident minutes) keyed by metric, grain, period and dimensions. A row replaces the live value only when its observed_at is newer; an older observation is kept in the restatement history and reported as stale. Requires workspace admin rank and the analytics.write scope; the public write key is refused.Changes data
analytics_projects_access_request_createAsk the project's owners for access at viewer or editor. Must ask higher than the role held (`400 access_role_not_higher`); `409 access_request_open` while one is open; `404` for an unknown project.Changes data
analytics_projects_access_request_currentReturn whether the caller has an open access request for the project.Read-only
analytics_projects_access_request_decideApprove at viewer or editor, or decline, an open access request. Project owners only. Returns 409 once decided.Changes data
analytics_projects_getRead one Analytics project, its view and the caller's role. `404` when the caller holds no role on it.Read-only
analytics_projects_listList the Analytics projects the caller holds a role on, each with its view and the caller's role. Workspace admins hold no implicit role: a private project an admin was not added to is not listed.Read-only
analytics_projects_permissions_listList the project's members: users and teams with their roles. The Everyone team row is the workspace tier.Read-only
analytics_query_executeExecute an ad-hoc analytics query (events/insights/funnel/retention/cohort). Returns structured results over the project's view (the workspace default project when project_id is omitted).Read-only
analytics_restricted_marks_listList the workspace's restricted event names, trait keys and metric keys. Workspace admin only.Read-only
analytics_retentions_createCreate a saved retention report.Changes data
analytics_retentions_getRead a saved retention report's name and stored query definition by ID, without computing retention. Use analytics_retentions_list to find report IDs. Requires a role on the report's project; `404` otherwise.Read-only
analytics_retentions_listList saved retention reports in the active workspace, including their names and query definitions. Lists one Analytics project (`project_id`) and requires a role on it.Read-only
analytics_retentions_updateUpdate a saved retention report.Changes data
analytics_settings_getGet the workspace's analytics settings — the timezone calendar windows such as today-7d and day/week/month buckets resolve in.Read-only
analytics_write_key_listList all writeKeys for the workspace (plaintext never returned on list).Read-only
append_sheet_valuesAppend rows of values to a sheet at the first empty row in a range. The server finds the insertion point — no need to read the last row first. Uses OVERWRITE semantics (does not shift existing data).Changes data
apply_deal_templateCreate a new deal from a saved deal template. The template provides default pipeline, stage, amount, probability, and line items. Use this when starting a deal that matches a known pattern (e.g., 'Standard Enterprise Plan').Changes data
apply_mail_ruleOpt in to a durable background application of this rule to a frozen, bounded cohort of matching received Inbox/Archive messages. Scopes above the preview candidate bound return 422 rule_preview_scope_too_large; narrow the conditions, folder or date range before applying. Nonempty jobs start queued and an empty cohort completes immediately; read progress with get_mail_rule_application. Forward is unavailable, Trash needs confirm_trash, and notification-only rules cannot apply. Retry the same request with the same idempotency_key. Explicit retire_unaccepted:true reconciles that exact original request: a matching existing job is returned unchanged; a different request returns 409. If no job exists, retirement durably spends the caller's personal-mailbox key as an empty cancelled job with no rule reference. Retirement does not read or authorize the requested rule, does not cancel admitted work, and excludes the retirement flag from request identity.Destructive
apply_master_to_slideLink a master slide to a specific slide by 0-based index. The slide stores a by-reference link, retains its existing elements as child-owned content, and clears prior master-element override markers. Current master elements inherit at render time and future master edits flow through automatically.Changes data
apply_task_templateCreate a new task by applying a template's defaults. The template pre-fills status, priority, estimate, assignee, description, and labels. Override any field by passing it explicitly. Title is always required.Changes data
apply_transition_to_allApply a slide transition to every slide in the deck. Set transition.type to 'none' to clear transitions on all slides. Prefer duration_s (float seconds, 0.1–10); legacy speed presets map to slow=1.0s, medium=0.5s, fast=0.3s.Changes data
archive_mail_threadArchive every inbox-folder message in a threadChanges data
asset_get_contentGet parent-owned image bytes for doc/sheet/deck/board/wiki/task, absent from Drive. Readable exactly by parent role/access, including external collaborators. Proxied, no redirect; Cache-Control:no-store. Active types including SVG and Canvas HTML download as attachments. With canvas_embeds off, HTML returns 404 module_unavailable; missing, inaccessible or invalid assets return 404. Transient storage failures return 503 asset_storage_unavailable with Retry-After.Read-only
auth_human_sessions_listList the caller's own active human client sessions across workspaces, current first then last server communication descending. A session is one authentication lineage, not an inferred physical device. Excludes agent credentials, API keys, app passwords, OAuth connections and memberships. Valid legacy sessions join the inventory when first observed; renewal writers need not be enabled.Read-only
auth_human_sessions_revokeSign out one of the caller's own human sessions, including its renewed JWTs, workspace selections and renewal family. Unknown or foreign session ids return404; repeating an own-session revoke succeeds without another effect. Current-session revocation requires the client to use its ordinary local exit flow.Destructive
auth_whoamiReturn the current authenticated user's profile (works with both JWT and API-key auth), including active workspace name + ID and agent kind + manager when applicable. needs_workspace_setup: true indicates the account has no workspace yet.Read-only
batch_archive_emailsArchive multiple emails in one atomic call. Moves all specified messages to the archive folder. Use this when the user wants to bulk-archive many emails (e.g., inbox-zero cleanup, archiving all messages from a sender).Changes data
batch_canvas_elementsUse to create, patch or delete several elements in one call (building a board, laying out a diagram, moving or deleting a group) instead of repeated create_canvas_element, patch_canvas_element or delete_canvas_element calls. operations run in order: create {element: the create_canvas_element body}, patch {element_id, patch: the patch_canvas_element body}, delete {element_id}. Each succeeds or fails alone with the reason its single-element tool gives; failures leave the rest applied. A create's temp_id works later wherever an element id goes (element_id, frameId, connector from/to element); temp_ids maps it to the minted id. Too many operations: 400 canvas_batch_too_large names the limit; split. Coordinates: board units, top-left origin, +x right/+y down. Example: batch_canvas_elements({id:"<boardId>", operations:[{op:"create", temp_id:"a", element:{type:"sticky", x:0, y:0, w:160, h:120, content:"Idea"}}, {op:"create", temp_id:"b", element:{type:"shape", shape:"rect", x:240, y:0, w:160, h:120}}, {op:"create", element:{type:"connector", from:{element:"a", anchor:"e"}, to:{element:"b", anchor:"w"}, x:0, y:0, w:0, h:0}}]}).Changes data
batch_clear_sheet_valuesClear all cell values in multiple ranges atomically. Sets cells to null without removing rows or columns. Useful for resetting template sheets or clearing data regions.Destructive
batch_file_permissionsBatch-fetch permissions for up to 50 files by ID. Returns a map of file_id → permissions array.Read-only
batch_get_contactsFetch multiple CRM contacts by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.Read-only
batch_get_dealsFetch multiple CRM deals by their IDs in a single request (max 100). Missing or inaccessible IDs are silently omitted from the result.Read-only
batch_get_filesBatch-fetch up to 50 files by ID. Powers drive:// embed hydration in Chat/Docs/Wiki/CRM.Read-only
batch_get_sheet_valuesFetch multiple disjoint ranges from a spreadsheet in a single request. Avoids N sequential round-trips when reading KPIs from different regions.Read-only
batch_modify_emailsBatch modify multiple emails in one atomic call. Can star/unstar, mark read/unread, add/remove labels, and change folder — all at once for up to 500 messages. Use this when the user wants to bulk-update many emails (e.g., star all from a sender, mark a batch as read, apply labels to multiple messages).Changes data
batch_trash_emailsTrash multiple emails in one atomic call. Moves all specified messages to the trash folder. Use this when the user wants to bulk-trash many emails (e.g., spam cleanup, clearing a project mailbox).Destructive
block_senderBlock a sender (address or domain).Changes data
book_event_resourcesBook one or more resources (rooms, equipment) for an existing event. Returns a conflict error if a resource is already booked.Changes data
browse_public_channelsBrowse the workspace's public channels, including the ones the caller has not joined, each with a `joined` flag and member count. `list_channels` returns memberships only, so this is the only way to discover a public channel you are not in and get the id `chat_channel_join` needs. Private channels and DMs are never listed. Use this when the user asks what channels exist, or asks to join a channel by name.Read-only
bulk_archive_tasksArchive up to 100 tasks at once. Only archives tasks the caller created or is assigned to.Changes data
bulk_copy_filesCopy multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. A copy into a shared-drive folder belongs to that drive.Changes data
bulk_delete_contactsDelete many CRM contacts in a single operation. Returns counts of deleted/skipped/failed items.Destructive
bulk_delete_dealsDelete many CRM deals at once by their ids.Destructive
bulk_delete_messagesSoft-delete up to 100 messages in a channel. Deletes only the IDs the caller may delete (own messages, or any message when the caller is a channel admin); every other ID returns in `rejected`. A batch affecting Slack-origin messages is refused with 409 before any deletion. Emits one bulk `message.deleted` event, never one per message.Destructive
bulk_delete_tasksSoft-delete multiple tasks at once by ID. Only deletes tasks the current user created. Max 100 task IDs per call. Subtasks cascade. Use `restore_task` to recover individually.Destructive
bulk_export_contactsExport selected contacts as CSV or vCard. CSV includes core fields and custom properties; vCard preserves imported RFC 6350 properties and parameters.Read-only
bulk_export_dealsExport selected deals as CSVRead-only
bulk_move_filesMove multiple files to a folder (max 100). The destination needs editor access (contributor in a shared drive); a folder the caller cannot see answers 404 like one that does not exist, and a visible one they cannot write to answers 403. Per-file failures come back in `errors`: "File not found" for a file the caller cannot view, "Forbidden" for one they can view but not edit. An item whose sharing is restricted (editors can't share, on it or a folder above it) moves only with its owner.Changes data
bulk_update_contactsUpdate many CRM contacts in a single operation. Useful for re-assigning ownership, updating lifecycle stage on a list of contacts, or reclassifying industry. Provide an array of contact IDs and the fields to apply to all of them.Changes data
bulk_update_dealsUpdate many CRM deals in a single operation. Useful for moving multiple deals to a new stage, reassigning ownership, or marking a batch of deals as won/lost. Provide an array of deal IDs and the fields to apply.Changes data
bulk_update_tasksBulk-update up to 100 tasks. Tasks you can't edit are skipped; `updated` counts the rest. Omitted fields stay unchanged; pass `null` to clear nullable fields.Changes data
calendar_attendee_identityResolve an attendee identifier to a current workspace member without changing the event or exposing foreign identities.Read-only
calendar_conflictsDetect attendee scheduling conflicts.Read-only
calendar_event_export_icsExport single event as .ics.Read-only
calendar_event_meeting_notes_createCreate a meeting-notes doc for an event, or — when `document_id` is given — link that existing doc and grant attendees access.Changes data
calendar_event_meeting_notes_unlinkUnlink meeting-notes doc.Destructive
calendar_event_reminders_createAdd a reminder to a calendar event.Changes data
calendar_event_reminders_listList event reminders.Read-only
calendar_event_reminders_setReplace reminder list.Changes data
calendar_event_unbook_resourcesRelease every resource booked for a calendar event.Destructive
calendar_export_icsExport entire calendar as .ics.Read-only
calendar_external_auth_urlStart external provider OAuth.Read-only
calendar_external_calendars_enable_syncEnable two-way sync.Changes data
calendar_external_calendars_listList calendars on connection.Read-only
calendar_external_connection_deleteDisconnect external account.Destructive
calendar_external_connections_listList connected external accounts.Read-only
calendar_external_force_syncSchedule an immediate background pull for this connection. A 202 response accepts the request; it does not report completion. Poll the connection's sync_state for the returned request_id until completed or failed. last_sync_at can advance during partial failure and is not a completion signal. Concurrent requests share the active request_id.Changes data
calendar_external_synced_disableDisable sync for one calendar.Destructive
calendar_import_ics_urlImport an .ics feed by URL. Fetches the URL server-side and imports its events into the calendar.Changes data
calendar_reminder_deleteDelete one calendar event reminder by id.Destructive
calendar_resource_deleteDelete a bookable calendar resource by id.Destructive
calendar_resource_getGet one bookable calendar resource by id.Read-only
calendar_resource_updateUpdate a bookable calendar resource's details.Changes data
calendar_resources_createCreate a bookable resource.Changes data
calendar_upcoming_remindersReminders due to fire within the next `window_hours` (default 24, max 168), soonest first. Each row carries the event it is about — title, span, status, location and calendar — so the caller renders the row without a second fetch.Read-only
calendars_createCreate a calendar in the current workspace.Changes data
calendars_deleteDelete a calendar and every event on it.Destructive
calendars_permissions_getGet a single user's permission entry on a calendar, including their role, display name, and email. Useful for checking if a specific user has access without listing all permissions.Read-only
calendars_updateUpdate calendar fields.Changes data
cancel_mail_rule_applicationStop an active application and restore its uncontested changes in the background; the rule remains enabled.Destructive
cancel_scheduled_emailCancel a scheduled emailDestructive
cancel_scheduled_messageCancel a pending scheduled message so it's never sent. Use this when the user says 'never mind' or changes their plan before the scheduled time.Destructive
cancel_scheduler_bookingCancel a booking as its host. The booked event is cancelled and the booker is always emailed the cancellation, with the optional message.Destructive
chat_channel_createCreate a chat channel in the workspace.Changes data
chat_channel_deleteDelete a chat channel and its messages.Destructive
chat_channel_engagementRank the caller's channels and DMs by their own recent engagement: posts, reactions, and mentions of the caller over the last 30 days, each decaying with a 7-day half-life. Only channels the caller can view; score descending.Read-only
chat_channel_getGet a specific channel by UUID, with members.Read-only
chat_channel_group_removeRemove a group from channel (clean up fan-out rows)Destructive
chat_channel_joinSelf-join a public channel (no body required)Changes data
chat_channel_last_messagesBatch-fetch the latest message preview for multiple channels in one request. Pass `ids` as a comma-separated list of channel IDs (max 100). Returns one entry per channel the caller can read, each carrying its `channel_id`. Replaces per-channel `GET /messages?limit=1` calls so a DMs/channels list renders previews without an N+1 request fan-out.Read-only
chat_channel_leaveLeave a chat channel you belong to.Changes data
chat_channel_member_removeRemove a member from a chat channel.Destructive
chat_channel_members_addAdd member(s) or a groupChanges data
chat_channel_notification_preferenceChoose your channel notification level: all_messages, new_threads_mentions, mentions_only, or nothing (Off). New human memberships default to all_messages; agent and coworker memberships default to mentions_only. All messages includes every new message and thread reply. New threads + mentions includes new top-level messages, direct mentions, broadcasts, and followed-thread replies. Mentions only retains addressed messages and followed-thread replies. Off suppresses notifications and attention badges while retaining readable content and unread bolding. DND pauses all Chat notifications; temporary mute still admits addressed mentions. The legacy unread_only input maps to all_messages for humans and mentions_only for agents and coworkers. Per-member; other members are unchanged. Pass user_id to set an agent's level as an admin, owner or the agent's manager; nobody sets another human's level.Changes data
chat_channel_notification_prefsUpdate the caller's per-channel notification preferences (unread_display: count | dot | since_visit).Changes data
chat_channel_updateUpdate a chat channel's name, topic or settings.Changes data
chat_draft_create_savedCreate a saved draft for the caller with text, files, or both. File metadata and suggested thread placement are private references, never access grants. An optional idempotency_key retains one creation identity and binds the ordered file metadata and placement; id requires that key. Matching retries return only { id, replayed: true }, including after discard. Read the draft normally for its current content. Optional source_draft_id and source_revision atomically consume an unchanged caller-owned saved original on the first creation; a newer original stays. A missing or inaccessible source returns 404 without creating a row or receipt. Replay never checks or consumes the source again.Changes data
chat_draft_deleteDelete a draft owned by the caller. Optional if_revision compares its saved Read draftRevision atomically; a changed draft returns 412 and remains saved.Destructive
chat_draft_updateUpdate a draft owned by the caller. Omitted attachments or suggested_thread_parent_id preserve existing authoring state; [] removes files and null clears suggested placement. This updates the row in place; use DELETE to discard it. Optional if_revision compares the saved Read draftRevision under a row lock; stale input returns 412 without changing the row.Changes data
chat_drafts_listThe caller's chat drafts (inflight + saved), newest first.Read-only
chat_emoji_imageServe custom emoji image from GCSRead-only
chat_mentions_inboxMessages from other users that @-mention the caller. Powers the Mentions tab.Read-only
chat_message_deleteDelete one message from a chat channel. Slack-origin messages must be deleted in Slack (409).Destructive
chat_message_send_receiptRead identity-only evidence for your retained keyed message in the current workspace. Requires Chat read and current channel membership. Live and spent both confirm an accepted retained row; spent returns no deleted content. Neither certifies delivery. A missing, purged, foreign, or inaccessible result is the same generic 404/unknown, never proof that sending did not occur and never permission to resend or replace the key. This Read posts nothing and creates no membership.Read-only
chat_message_updateEdit an Ambiguous-origin message or pin/unpin. Slack-origin content must be edited in Slack (409).Changes data
chat_preferencesWorkspace-level chat preferences readable by any authenticated member (default_reactions).Read-only
chat_reactions_inboxMessages authored by the caller that carry reactions from other users. Powers the Mentions & Reactions inbox.Read-only
chat_saved_ids_listGet saved message IDs for a channel (for UI bookmarked state)Read-only
chat_sidebar_create_sectionCreate a custom chat-sidebar section for the caller.Changes data
chat_sidebar_delete_sectionDelete a chat-sidebar section owned by the caller.Destructive
chat_sidebar_list_sectionsThe caller's custom chat-sidebar sections by position, plus the order every movable section (custom, Channels, Direct) renders in.Read-only
chat_sidebar_place_channelMove a conversation into one of your sections. Set sectionId to null to return it to its default place. Only your sidebar changes, and other conversations stay where they are.Changes data
chat_sidebar_reorder_sectionsReorder the caller's sidebar sections. Pass every movable section — custom ids plus "channels" and "direct" — top to bottom. Starred stays first and More last.Changes data
chat_sidebar_update_sectionRename a chat-sidebar section or set its channels.Changes data
chat_thread_activity_listList thread-activity inbox for the current user. Powers the sidebar "Threads" inbox entry. Returns readable threads the user participates in or explicitly marked unread, with peer-only unread counts and own-inclusive unread anchors.Read-only
chat_thread_getGet the replies in a chat message's thread.Read-only
check_availabilityCheck free/busy availability for one or more users in a given time range. Returns busy time slots (not event details) for each user. Use this when the user asks to find a free time, check if someone is available, or schedule a meeting. Call this before create_event to avoid scheduling conflicts.Read-only
check_resource_availabilityCheck if a specific resource (room, equipment) is free in a time range. Call before booking to avoid conflicts.Read-only
check_workspace_slugCheck whether a workspace slug is available.Read-only
claim_documentMake an unclaimed document yours. A document, spreadsheet, presentation or board created without an account returns a single-use `claim_key`; call this with it after signing in and the document moves into your active workspace with you as owner, keeping its id and URL. Its link drops to view-only, which you can raise again. A second claim of the same document, or a wrong key, is refused with 409 `claim_rejected`, which does not say which.Changes data
clear_calendarDelete ALL events from a calendar. Owner-only — use for resetting shared calendars at quarter boundaries or wiping test data. Returns the count of deleted events. This is irreversible.Destructive
clear_reminderClear a pending reminder on a saved message. The message stays saved; only the reminder is removed.Destructive
clear_sheet_validationRemove a data validation rule from a spreadsheet by range. The range is matched after normalization (sheet tab defaults to Sheet1 if not specified). Returns 404 if no rule exists for that range.Destructive
clear_user_statusClear the current user's status (emoji + text + expiresAt). Does NOT change DND — use set_user_dnd with until=null to clear DND separately.Destructive
code_connections_listList repositories offered by the workspace GitHub installation. Workspace administrators only.Read-only
code_pull_changes_since_reviewCompare the caller's last reviewed head with the current head. Historical or truncated source is explicitly reported.Read-only
code_pull_commitRead the diff for one commit in this pull request.Read-only
code_pull_createCreate/adopt a GitHub PR with accountable Ambiguous author. Base defaults to repo target; retry same idempotency key. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_pull_exportExport the complete review record with original anchors and attribution as versioned JSON or Markdown.Read-only
code_pull_getRead a native review, its revision, discussion, checks and merge blockers. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Read-only
code_pull_refreshReconcile with current GitHub state. Never interprets an older webhook as current source truth. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_pull_reviewSubmit a review for the specified comparison as an authenticated user or agent with repository review permission. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_pull_updateEdit metadata, assign reviewers, follow, close, reopen or mark ready. Requires the last read version. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_pulls_listPermission-filtered pull request inbox, newest update first. Each item is a summary of what an inbox row shows; read one pull request with code_pull_get for its files, commits, description, comment bodies and activity. Pass the returned nextCursor as cursor for the next page; nextCursor is null after the last page. A page may hold fewer than limit items while nextCursor is not null.Read-only
code_repositories_listList repositories the caller can read, with their Code role.Read-only
code_repository_compareCompare two repository refs before opening a pull request.Read-only
code_repository_connectConnect a repository from this workspace's existing GitHub installation. Workspace admin only; grants the connector repository ownership.Changes data
code_repository_grantsRead repository access grants. Repository owner only.Read-only
code_repository_metadataRead the repository labels and milestones available for pull requests.Read-only
code_repository_principalsList workspace users and teams available for an explicit repository grant. Repository owner only.Read-only
code_repository_reviewersList currently eligible Ambiguous reviewers, including agents.Read-only
code_repository_updateUpdate the default target branch, review policy or connection. A null target resets to GitHub's default branch. Repository owner only.Changes data
code_review_dismissDismiss a blocking review with an auditable reason. Maintainer only. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_review_resolveResolve or reopen a review without changing its verdict. The PR author or maintainer may resolve another reviewer's feedback. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
code_review_startStart your draft review, or return the one you already have. Add pending inline comments with create_resource_comment on the draft's id; submitting the review publishes them with its decision. The response carries every file patch, thread and activity entry. Pass `fields` to return only what you need, for example `id,version,blockers,data(mergeIntent,syncError,provider(state,headSha,baseSha,baseRef,mergeable,checks))`.Changes data
compute_pivot_tableCompute the result of a persisted pivot table — applies row/column grouping, value aggregation, sort orders, and any matching slicer filters, and returns the rendered cells. The pivot config itself (row/column/value fields, source range) is not modified.Read-only
compute_wiki_rollupsCompute and return rollup values for all rows in the database. Each rollup aggregates a property across related rows.Read-only
copy_sheet_toCopy a sheet tab from one spreadsheet to another. Deep-copies columns, rows, formulas, formatting, and merges. Cross-document formulas will show as #REF!. Requires viewer access on source and editor access on destination.Changes data
create_canvasCreate a new (empty) canvas — a Miro-style infinite whiteboard. Use when starting a fresh flowchart, product map, or swimlane flow; returns the canvas envelope with an empty `data.elements`, then add objects with create_canvas_element. Coordinates: board units, top-left origin, +x right / +y down. Example: create_canvas({ title: "Q1 product map" }) → { id: "<boardId>", data: { elements: [] } }.Changes data
create_canvas_elementUse to create a new sticky/text/shape/image/codeBlock/frame/swimlane/connector/metric/embed/portal. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Fields are flat, id is the board; server mints element id and preserves others. Coordinates: board units: top-left origin, +x right/+y down; x, y, w, h geometry. Type fields: sticky/text content; shape shape/content; image src; codeBlock code/language; frame name/metricWindow; metric report insights:<id>|funnels:<id>, optional step/title/window {from, to} (today-28d/now), live report values. Connector from/to: {element, anchor:n|s|e|w} follows shapes; {point:{x, y}} stays fixed; x, y, w, h=0. Example: create_canvas_element({id:"<boardId>", type:"sticky", x:100, y:80, w:160, h:120, content:"Idea"}). Embed: sandboxed frame, kind html/url, title, interactive=false (no scripts/forms); true allows interaction. html for kind html or src for kind url; https URL required (400 embed_url_invalid). Never send src for html. HTML: inlined single file, 5 MB UTF-8 max (413 embed_html_too_large), stored board asset/src. Responses/board reads: src, never markup; only get_canvas_elements with one id returns html. No markup messages; comments reach you by mention or reading the board, never wake you unmentioned. Embed example: create_canvas_element({id:"<boardId>", type:"embed", kind:"html", title:"Mockup", interactive:false, x:0, y:0, w:640, h:480, html:"<!doctype html><button>Pay</button>"}). canvas_embeds off: create, html/src/interactive patches, URL mint, serve, both asset markup reads 404 module_unavailable; single read omits html; move/resize/rename/lock/delete work. Portal: live targetId as viewer; modules/selectors/default sizes docs {}/480x640, slides {slide} zero-based first default/480x270, sheets {range} A1 import-range cap/560x320, canvas {frameId}/560x400. Wrong-module/malformed/over-cap 400 portal_selector_invalid; inaccessible target module 404; title server-written create/patch, never send. Host board/portal-containing frame 400 portal_recursive; connection 400 portal_not_connectable, use create. Geometry required. Example: create_canvas_element({id:"<boardId>", type:"portal", module:"sheets", targetId:"<id>", selector:{range:"Sheet1!A1:D10"}, x:0, y:0, w:560, h:320}). canvas_portals off: create/selector patch 404 module_unavailable.Changes data
create_chartEmbed a chart on a tab of the sheet. Charts visualize a rectangular data range — pick a chart type (bar / line / pie / scatter), the source range, and an overlay position. Returns the created chart with its server-assigned id.Changes data
create_contactCreate a new CRM contact (person or company). Persons can be linked to a company via company_id. IMPORTANT: Before creating a contact, ALWAYS call list_contacts with a search query (q) to check if a contact with the same name or email already exists. If a matching contact is found, use update_contact instead of creating a duplicate. Only create a new contact if no match is found. Use this when the user asks to add a contact, log a lead, or create a company record.Changes data
create_contact_groupCreate a named contact group for organizing contacts. Groups allow overlapping membership — a contact can be in multiple groups.Changes data
create_crm_lifecycle_stageAdd a People lifecycle stage with an immutable key. Workspace admins only. Keys cannot be deleted or reused; archive a stage to hide it from assignment controls.Changes data
create_crm_property_definitionDefine a typed custom property for contacts or deals. field_type 'relation' (with relation_target contact|company|deal) makes the property a link to another record: values written to custom_properties under this key must be the id of an existing record of the target type.Changes data
create_crm_viewCreate a saved CRM view: a named filter+sort preset for contacts, companies, or deals. Useful when the user asks to 'save this filter' or 'create a view for high-value deals'.Changes data
create_dealCreate a new CRM deal (revenue opportunity). Deals belong to a pipeline and sit in a specific stage. Link to a contact and/or company. Use this when the user asks to create a deal, log an opportunity, or start tracking a sale.Changes data
create_deal_templateCreate a deal template — a reusable preset for creating deals with standard pipeline/stage/amount and line items. Use when the user has a repeatable sale like 'Standard Enterprise Plan'.Changes data
create_docCreate a new doc. `content` is Markdown (recommended) or a ProseMirror JSON string. Returns the created document; read, update, share and trash it through the `/api/documents/{id}` operations. For a spreadsheet use `create_sheet`, for a deck `create_presentation`, for a whiteboard `create_canvas`.Changes data
create_draft_emailCreate a draft email without sending it. The draft is saved in the drafts folder for later review, editing, or sending. Use this when the user wants to compose an email for later, save a draft, or prepare a message without sending it immediately. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.Changes data
create_eventCreate a new calendar event. Requires a title, start time, and end time. Optionally add a description, location, attendees, recurrence, and more. Use this when the user asks to schedule a meeting, add an event, or book time. If the user doesn't specify a calendar, use list_calendars to find their default calendar ID first.Destructive
create_folderCreate a new folder in Drive. Returns the created folder with id, name, and path. Use this when the user asks to create, make, or add a new folder for organizing files. Supports nested folders via parent_folder_id.Changes data
create_formCreate a new form for collecting data (surveys, feedback, registrations, quizzes). Returns the created form with id and public slug. Use this when the user asks to create a survey, questionnaire, feedback form, registration form, or any structured data collection. Define fields with types, labels, validation, and optional conditional logic.Changes data
create_form_variantCreate a new A/B test variant by duplicating the parent form. Optionally override fields to change question wording, field types, options, or validation. Traffic weight (0–100) controls the percentage of visitors who see this variant versus the control. Use when the user asks to set up an A/B test or add a variant.Changes data
create_mail_labelCreate a mail label for organizing threads.Changes data
create_mail_templateCreate a reusable mail template for composing.Changes data
create_named_rangeCreate a named range or named expression on a spreadsheet. Send either an A1 range or an exact literal Excel expression, such as a structured table reference. External-workbook expressions are preserved verbatim and remain unresolved.Changes data
create_pipelineCreate a new CRM pipeline with ordered stages. Each stage has a name and an optional default probability (0-100). Most workspaces need only one pipeline; create additional ones for distinct sales processes (e.g., 'New Business' vs 'Renewals').Changes data
create_pivot_tableCreate a pivot table from sheet data. A new sheet tab is automatically created to hold the pivot. Specify the source data range, which columns to group by (rows/columns), and which columns to aggregate (values).Changes data
create_presentationCreate a new presentation deck. Omit `content` for a deck with one blank slide, or pass deck JSON to create it with its slides in place: `{ slides: [{ elements: [{ type: "text", x: 80, y: 60, w: 800, h: 80, text: "Q1 review", fontSize: 44 }] }] }`. A slide is 960 by 540 units with a top-left origin, and elements take the shape `add_slide` accepts. Returns the created `SlideDeck` envelope.Changes data
create_productCreate a product in the workspace catalog. Products are the reusable items that can be attached to deal line items and quote line items. Set is_active=false to retire without deleting.Changes data
create_projectCreate a new project to group related tasks. A bound document or Wiki page atomically selects the new project; named source editor access is required. An already-bound source or a bound project with workspace visibility is refused.Changes data
create_project_updatePost a status update on a project. Use this when the user wants to report progress, flag a risk, or share a status update on a project. The status field captures the health signal (on_track, at_risk, off_track, paused, completed, cancelled).Changes data
create_quoteCreate a CRM quote (proposal) with line items. Auto-computes subtotal, tax, discount, and total. Link to a deal/contact/company via IDs. Status defaults to 'draft' — use send_quote to email it.Changes data
create_resource_commentCreate a comment on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. Replies use parent_id. anchor points at a passage, cell, slide, board point or element, Drive file region, or diff line; each container accepts only its own kinds and refuses others with 400 comment_anchor_invalid, and tasks and mail conversations take no anchor. idempotency_key makes a retry return the original comment. Mail comments are internal notes and cannot be sent as email.Changes data
create_scheduler_linkCreate a scheduler link (booking page). Returns the public URL slug and availability settings. If auto_create_contact is true, every booking auto-creates a CRM contact + deal.Changes data
create_scoring_ruleCreate a lead scoring rule. When a contact matches (field + operator + value), the specified points are added to their lead score. Positive points indicate engagement; negative points indicate disqualification signals.Changes data
create_sequenceCreate a multi-step CRM sequence (email/wait/task/call/branch steps). Use this when the user asks to build a nurture campaign or outreach cadence.Changes data
create_shared_driveCreate a shared drive. Creator becomes a manager.Changes data
create_sheetCreate a new spreadsheet. Returns the full `Sheet` envelope (id, title, owner, visibility, timestamps, and `data` body) so the caller can immediately read or edit cells without a second round-trip. Optional `content` may be a SheetData JSON object or a string that parses as JSON.Changes data
create_sheet_imageCreate editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.Changes data
create_sheet_picture_groupCreate editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.Changes data
create_sheet_shapeCreate editable floating shapes with editable text, cell anchors and CSS pixel geometry.Changes data
create_sign_documentCreate a draft signing document.Changes data
create_sign_templateCreate a reusable signing template from field layout and signer roles. A Doc source is rendered to an independent frozen PDF snapshot. Choose either source_doc_id or source_pdf_file_id.Changes data
create_slicerAdd a slicer to a tab of the sheet. Slicers filter pivot tables and charts that share the same source range by the values selected for a single column. `selectedValues: null` passes everything through; `[]` filters everything out; a non-empty array passes only those values. Returns the created slicer with its server-assigned id.Changes data
create_slide_masterCreate a new master slide for a deck. If no elements are provided, a default Title + Subtitle layout is used.Changes data
create_sparklineCreate a native editable sparkline in one cell from a worksheet row or column.Changes data
create_subtaskCreate a subtask under the given parent task. Equivalent to `POST /api/tasks` with `parent_task_id` pre-filled from the URL parameter.Changes data
create_taskCreate a new task. Auto-subscribes the creator and (if assigned) the assignee. Auto-sets SLA due date when priority is set without an explicit due_date. Auto-logs a CRM activity if linked to a contact.Changes data
create_teamCreate a new team in the workspace. The caller becomes the team admin. Teams can serve as email distribution lists (when email_local_part is set) and/or permission targets. Use this when the user asks to create a team, distribution list, or mailing list.Changes data
create_wiki_pageCreate a new wiki page within a space. Pages use Markdown content and support nested hierarchies via parent_page_id. Use this when the user asks to create a wiki page, add documentation, write a runbook, or add to the knowledge base. Call list_wiki_spaces first to get the space ID.Changes data
create_wiki_page_versionCreate a manual snapshot of the current wiki page state. Useful before a risky edit or when the user wants to mark a 'known good' checkpoint. Optional `label` names the snapshot. Returns the new version's id + metadata.Changes data
create_wiki_spaceCreate a new wiki space (a top-level container for pages). Use this when the user asks to create a new knowledge base area, team wiki, or documentation section. Spaces organize pages by team or domain (e.g., 'Engineering', 'Product', 'Company Handbook').Changes data
create_wiki_synced_blockCreate a synced block — a reusable content fragment that can be embedded in multiple wiki pages and stays in sync everywhere it's used. Returns the new block's id. Use this when the user asks to create a shared snippet, reusable callout, or cross-page content.Changes data
crm_contact_file_attachCopy a readable Drive file into a contact-owned attachment. The copy is readable by the contact readers; the original file and its sharing remain unchanged. A native doc, sheet, deck, canvas or form without stored bytes returns 422 `native_document_not_copyable`; attach it as a link.Changes data
crm_contact_file_detachDetach a file from a contactDestructive
crm_contact_files_listList files attached to a contactRead-only
crm_contact_photo_getServe the photo image stored for a CRM contact.Read-only
crm_deal_activitiesList activities for deal (owner-scoped)Read-only
crm_deal_file_attachCopy a readable Drive file into a deal-owned attachment. The copy is readable by the deal readers; the original file and its sharing remain unchanged. A native doc, sheet, deck, canvas or form without stored bytes returns 422 `native_document_not_copyable`; attach it as a link.Changes data
crm_deal_file_detachDetach a file from a dealDestructive
crm_deal_files_listList files attached to a dealRead-only
crm_quote_pdfExport quote as PDF (or printable HTML with ?format=html)Read-only
cycles_add_tasksAdd tasks to the cycle. Body `{task_ids: [...]}`.Changes data
cycles_analyticsBurndown + summary analytics for the cycle.Read-only
cycles_completeComplete a cycle. If `auto_rollover` is set, incomplete tasks are moved to the next cycle.Changes data
cycles_createCreate a new cycle. Body fields: name, start_date, end_date, status?, cooldown_days?, auto_rollover?.Changes data
cycles_deleteDelete a cycle. Tasks attached to the cycle are unlinked, not deleted.Destructive
cycles_getGet one task cycle and its dates by id.Read-only
cycles_listList cycles in the active workspace. `?status=` filters by status; `?limit=` (1–200) and `?offset=` paginate. `has_more` is set when the underlying query returned a hint of more rows.Read-only
cycles_remove_tasksRemove tasks from the cycle. Body `{task_ids: [...]}`.Destructive
cycles_updateUpdate cycle fields.Changes data
cycles_velocityCross-cycle velocity (last N closed cycles). Default `limit=10`.Read-only
decide_access_requestApprove an open access request at a named role, or decline it. Only principals entitled to share the resource may decide. Returns 409 once decided.Changes data
decide_mail_approvalApprove and send, request changes, reject, or (as the sender) withdraw one submitted email. The decision names the revision it applies to: exactly one decision per revision succeeds, and a decision on a superseded revision conflicts rather than releasing content the caller has not read. Approving records the human and time against that revision; it authorizes nothing else — not the thread, not a reply, not a later email.Changes data
delete_activityDelete one logged CRM activity by id.Destructive
delete_canvas_elementDelete one element from a board by id. Use when removing an object; connectors attached to it are not auto-deleted, so patch or delete those separately. A locked element answers 409 element_locked; unlock it first. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Every other element is untouched. Coordinates: board units, top-left origin, +x right / +y down (unchanged by a delete). Example: delete_canvas_element({ id: "<boardId>", elId: "<elId>" }).Destructive
delete_chartRemove a chart from the sheet. Returns `{ deleted: true }` on success.Destructive
delete_conditional_formatDelete a conditional formatting rule from a spreadsheet by its ID. Returns 200 on success, 404 if the rule does not exist.Destructive
delete_contactDelete a CRM contact (owner-scoped). Permanently removes the contact record. Use with caution — prefer updating lifecycle_stage to 'evangelist' or archiving via merge instead.Destructive
delete_contact_groupDelete a contact group. Memberships are removed but contacts themselves are preserved.Destructive
delete_contact_photoDelete a CRM contact's profile photo. Clears the avatar_url and removes the stored image.Destructive
delete_crm_property_definitionDelete a custom-property definition. Existing custom_properties values are left in place; they simply stop being typed.Destructive
delete_crm_viewDelete a saved CRM view.Destructive
delete_custom_emojiDelete a custom emoji from the workspace. Use this when the user asks to remove or clean up a custom emoji. This does not remove existing reactions or messages that used the emoji — it only stops new usage.Destructive
delete_data_connectorDelete a data connector. Does not affect the cells it previously wrote to.Destructive
delete_dealDelete a CRM deal (owner-scoped). Permanently removes the deal record and its line items. Prefer updating status to 'lost' with a lost_reason for reporting purposes.Destructive
delete_deal_line_itemDelete a deal line item. By default the deal's total amount is re-synced after deletion.Destructive
delete_deal_templateDelete a deal template (does not affect deals previously created from it).Destructive
delete_document_versionDelete a version snapshot of a document. At least one version must always remain — returns an error if attempting to delete the last version. Requires editor permission.Destructive
delete_emailDelete one email message by id.Destructive
delete_eventDelete a calendar event. This is a destructive action — always confirm with the user before calling. If the user is currently viewing an event, use the event ID from the page context. Guests are emailed a cancellation only when `send_updates` asks for it.Destructive
delete_fileDelete a file or folder from Drive. This is a destructive action — always confirm with the user before executing. Deleting a folder also deletes all files inside it. Use this when the user explicitly asks to delete, remove, or trash a file or folder.Destructive
delete_formDelete a form and all its responses. This is a destructive action — always confirm with the user before executing. Use this when the user explicitly asks to delete or remove a form.Destructive
delete_form_responseDelete a single form response. This is destructive — always confirm with the user before executing. Use when the user asks to remove or delete a specific submission.Destructive
delete_form_variantDelete an A/B test variant (and its underlying duplicated form). Destructive — always confirm with the user. Use when the user asks to remove a variant or end an experiment.Destructive
delete_mail_labelDelete one mail label from this mailbox.Destructive
delete_mail_ruleDelete one mail rule by id.Destructive
delete_mail_templateDelete one saved mail template by id.Destructive
delete_named_rangeDelete a named range from a spreadsheet by name. Names are matched case-insensitively.Destructive
delete_pipelineDelete a CRM pipeline and all of its stages. Deals in the pipeline must be moved or deleted first.Destructive
delete_pivot_tableRemove a pivot table from the sheet. The host tab itself stays — only the pivot row in `pivotTables[]` is removed. Returns `{ deleted: true }` on success.Destructive
delete_productDelete a product from the workspace catalog. Existing deal/quote line items referencing it are NOT deleted, but their product_id is nulled.Destructive
delete_projectDelete a project by ID. Only project admins or workspace admins can delete. Tasks belonging to the project are not deleted — they become unassigned from the project.Destructive
delete_quoteDelete a CRM quote and its line items.Destructive
delete_recurring_event_futureDelete this and all future occurrences of a recurring event by adding an UNTIL clause to the master's RRULE, ending the series the day before the given split_date. When no occurrence starts before split_date, the whole series (master and every exception) is deleted instead.Destructive
delete_recurring_event_singleDelete a single occurrence of a recurring event by adding the occurrence date to the master's excluded_dates. The occurrence is suppressed without affecting other instances.Destructive
delete_resource_commentDelete a comment by its ID. Its author, or anyone with the container's moderate access, may delete it; deleting a thread's first comment deletes its replies.Destructive
delete_scheduler_linkDelete a scheduler link. Existing confirmed bookings remain but the public booking page stops accepting new bookings.Destructive
delete_scoring_ruleDelete a lead scoring rule.Destructive
delete_sequenceDelete a sequence (and all its enrollments).Destructive
delete_shared_driveDelete a shared drive (destructive, manager-only).Destructive
delete_sheet_columnsDelete columns atomically and return the bounded change receipt for undo or redo.Destructive
delete_sheet_imageDelete editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.Destructive
delete_sheet_picture_groupDelete editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.Destructive
delete_sheet_rowsDelete rows from a sheet tab by 0-based index.Destructive
delete_sheet_shapeDelete editable floating shapes with editable text, cell anchors and CSS pixel geometry.Destructive
delete_slicerRemove a slicer from the sheet. Returns `{ deleted: true }` on success.Destructive
delete_slide_masterDelete an unused master slide. Returns 409 with the referencing slide count while the master is in use.Destructive
delete_sparklineDelete one editable sparkline without changing its source cells.Destructive
delete_teamPermanently delete a team from the workspace. Only team admins or workspace admins can delete. All memberships are removed. Child teams are orphaned (parent set to null). Use this when the user asks to delete, remove, or dissolve a team.Destructive
delete_wiki_pageMove a wiki page to Trash, together with every page beneath it. Trashed pages leave the tree and search, and can be brought back with `wiki_page_restore`; only `wiki_page_permanent_delete` removes them for good. A page that has child pages answers 409 with `requires_cascade` and `children_count` unless `cascade=true` is passed, so confirm with the user before trashing a sub-tree. Use this when the user asks to delete or remove a wiki page.Destructive
delete_wiki_synced_blockSoft-delete a synced block. Embedded references will show error chips until restored. Use restore_wiki_synced_block to undo.Destructive
detach_master_from_slideDetach a slide from its master. The slide keeps its current rendered elements but no longer inherits from the master.Changes data
docs_create_named_rangeCreate a named range (template placeholder) on a document. Named ranges anchor to ProseMirror node positions and are used for template-based document generation. Use replace_named_range_content to fill a named range with content. Name must be alphanumeric + underscore, must not start with a digit (e.g., party_name, companyAddress).Changes data
docs_delete_named_rangeDelete a named range (template placeholder) from a document by name. Names are unique per document.Destructive
docs_list_named_rangesList all named ranges (template placeholders) defined on a document. Returns each range's name and its anchored node positions.Read-only
documents_asset_createAdd an image to a doc/sheet/deck/board. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.Changes data
documents_deleteSoft-delete a document (move to trash). Owner only.Destructive
documents_duplicateMake a copy. Title becomes 'Copy of <orig>'. Visibility resets to restricted; labels/pin/star are NOT inherited. Requires viewer access on the source.Changes data
documents_export_job_contentThe finished file of a succeeded export job, as an attachment, for the requester only. download_url names this path when the storage cannot sign a URL; otherwise use the signed URL.Read-only
documents_export_job_createStart a PDF or DOCX export of a document, sheet, or slide without waiting for the render. Returns 202 with the job and status_url at once; the Location header points to the same path. Poll status_url until status is succeeded, then fetch download_url, or failed, whose error carries the status the synchronous export would have answered. The same idempotency_key returns the same job. Requires viewer access, and only the requester can read the job.Changes data
documents_export_job_getRead an export job started with documents_export_job_create. When status is succeeded, download_url is a short-lived signed URL for the file; read the job again for a new one. Only the requester, while still able to view the document, can read it; anyone else gets 404.Read-only
documents_pinToggle pinned state. Editor permission required (workspace-wide pin, not per-user).Changes data
documents_restoreRestore a trashed document.Changes data
documents_shared_with_meDocuments shared with the calling account through an explicit permission grant, across every workspace and every identity the account owns. Excludes documents the account owns. Each row names the workspace that shared it and the role the grant carries. `scope=workspace` narrows discovery to resources in the authenticated current workspace without changing access.Read-only
documents_tasks_adoptMove the caller's project-less tasks linked from this doc into `project_id`; set the doc's tasks project if unset. Other linked tasks are listed in `skipped` and unchanged.Changes data
documents_thumbnailContent-derived thumbnail for doc/sheet/slide cards. Returns SVG by default or PNG for Accept: image/png; cached privately for 60 seconds.Read-only
documents_trash_listFind all deleted native Docs, Sheets, Slides and Canvas items owned by the caller. Returns their document IDs for documents_restore or documents_permanent_delete; optional type filters doc, sheet, slide or canvas. Uploaded Drive files and folders use list_trashed_files, which can also include materialized native-document shadow rows but is not a complete native-document trash list. An empty Drive-file trash result does not mean this document trash is empty.Read-only
documents_version_getGet a version's metadata + serialized content snapshot.Read-only
documents_version_revertRevert the document to a prior version. Force-snapshots current state first.Changes data
documents_versions_createCreate a manual snapshot (forces past the 5-minute throttle).Changes data
documents_versions_listList version snapshots, newest-first, cursor-paginated (default 50 per page). Walk via `next_cursor` until `has_more` is false.Read-only
drive_file_confirm_uploadConfirm a presigned upload completed successfully. Verifies the blob exists, rechecks its real size and stored bytes, then marks the file as confirmed and emits the upload event. A retryable storage-inspection failure leaves the upload pending and returns 503; a missing object removes the pending row and returns 410. Idempotent — confirming an already-confirmed file returns it unchanged without repeating the upload event.Changes data
drive_file_contentA file's bytes. A native item without stored bytes returns 422 native_document_not_copyable; attach it as a link. A browser is redirected to a short-lived signed storage URL where signing is available and is otherwise sent the bytes; an MCP tool call always gets the bytes, refused 413 above the MCP result size limit. Pass `?download=true` for `Content-Disposition: attachment`; default is inline. Content retrieval failures can return 503/504 via raw Response because those statuses are outside the typed contract error-code enum.Read-only
drive_file_importAdd a file to Drive from JSON, for clients that cannot send multipart: give either an https `url` to fetch (up to 100 MB) or the bytes as `content_base64` (up to 25 MB decoded), plus a `name`. The file goes through the same checks as a browser upload: its type is decided from the bytes, blocked types are refused, and it counts against the caller's storage quota. Links to private network addresses are refused, including through redirects. Returns the stored file.Changes data
drive_file_request_revokeRevoke a folder's public file request immediately.Destructive
drive_file_requests_listList the caller's file requests for one owned Drive folder.Read-only
drive_file_tag_attachAttach one of your tags to a Drive file, a doc/sheet/slide, or a form, so one tag can group a PDF with the document it belongs to. Owner-only (anyone else gets 404) and idempotent. Pass `resource_type` to name the kind, or omit it to infer it from the id.Changes data
drive_file_tag_detachDetach a tag from a Drive file, a doc/sheet/slide, or a form. Owner-only. Pass `?resource_type=` to name the kind, or omit it to infer it from the id.Destructive
drive_file_updateRename, move, or star/unstar a file. Rename and move require edit access; stars are owner-only. A move also needs editor access on the destination folder (contributor in a shared drive), and an item whose sharing is restricted moves only with its owner (403 `drive_move_requires_owner`).Changes data
drive_file_upload_initInitiate a file upload. Reserves a Drive row + storage key and returns a short-lived presigned PUT URL the client uploads the bytes to.Changes data
drive_files_recentRecently used files for the current user — files they opened in the last 30 days (their own views, including files shared with them that they can still open) OR files they own created in the last 24 hours. Sorted newest first by their own last view, or creation for their own new files.Read-only
drive_files_shared_with_meFiles shared with the current user through a direct, team or external grant, newest share first (`sort=modified` orders by last modified instead). Each row carries `shared_at` and `shared_by`. Excludes files the user owns.Read-only
drive_files_starredFiles the current user has starred.Read-only
drive_files_suggestedFiles the current user is likely to want next, each with the reason it is suggested: they opened it (`opened`), someone shared it with them (`shared`), or someone else added it to a folder they own or an agent they manage created it (`added`). Covers the last 14 days, newest reason first, at most one entry per file and only files the caller can still open. Stars never influence it. Use this for the My Drive home, not for a full history; use `drive_files_recent` for everything the user opened.Read-only
drive_folder_ancestorsBreadcrumb chain (root → leaf) for a folder. Powers breadcrumb hydration on deep-link reloads. Viewer permission is sufficient.Read-only
drive_revoke_galleryRevoke a folder gallery: restore the folder and its direct-child files to restricted and clear link settings. Owner-only. Legal-record children are left untouched.Destructive
drive_shared_drive_folder_createCreate a folder inside a shared drive. Requires contributor+ on the drive. Pass `parent_folder_id` to nest.Changes data
drive_tag_createCreate a new tag in the user's catalog.Changes data
drive_tag_deleteDelete a tag (cascades to all file assignments).Destructive
drive_tag_files_listList everything you tagged with the given tag: Drive files, docs/sheets/slides and forms you own, newest first. Docs and forms carry `document_type`.Read-only
drive_tag_updateRename, recolor, or reorder a tag.Changes data
drive_tags_listCurrent user's tag catalog. Each tag carries name, color, and sort order.Read-only
duplicate_slideDeep-copy a slide within the same deck. The duplicate is inserted immediately after the source slide. All elements (including group children) receive new unique IDs to avoid collisions. Useful for template-based workflows: duplicate a template slide, then update the copy with new content.Changes data
duplicate_taskClone a task — copies title (appends ' (copy)'), description, priority, project, goal, cycle, estimate, due/start date, recurrence, custom fields, and labels. The clone starts at status 'todo' with a fresh task key.Changes data
edit_recurring_event_allEdit all occurrences in a recurring series. Updates the master event.Changes data
edit_recurring_event_futureEdit this and all future occurrences of a recurring event by splitting the series at the given date. Use this for 'change the meeting time from next week onwards' or 'update our recurring Friday sync starting next month'.Changes data
edit_recurring_event_singleEdit a single occurrence of a recurring event, creating an exception without affecting other occurrences. Use this when the user says 'move just next Tuesday's meeting to 3pm' or 'cancel only this one occurrence'.Changes data
ensure_wiki_reverse_relationAuto-create the reverse relation property on the target database if missing. Idempotent — returns the existing or newly-created reverse property id.Changes data
export_documentExport a document, sheet, or slide to one of its supported standard formats. Sheets support xlsx, csv, tsv, and ods. Returns the file bytes with Content-Type and Content-Disposition attachment headers.Read-only
export_drive_fileExport a workspace document (Doc, Sheet, or Slide) to a file format via its Drive ID. Docs support: docx, pdf, html, md. Sheets support: xlsx, csv. Slides support: pptx, pdf, html. Binary Drive files (images, archives, etc.) cannot be exported — use download instead.Read-only
export_form_responsesDownload all matching form responses as CSV with field labels, display values, blank unanswered cells, and ISO submission timestamps. Streams beyond the response-list page size.Read-only
export_mail_rulesDownload mailFilters.xml or an exact Ambiguous JSON backup. Use preview_mail_rule_export first to inspect every Gmail loss and omission.Read-only
find_and_replace_in_deckFind and replace text across all slides in a presentation. Searches every text element and table cell on every slide. Useful for template-based workflows: create a deck from a template with placeholders like {{company_name}}, then replace them programmatically. Plain string matching only (no regex).Changes data
formatter_setSet a flat map of fields on the node output. Native equivalent of the n8n `Set` node — alias `n8n-nodes-base.set → formatter_set`. Pure passthrough: `parameters.values` is resolved upstream by the dispatcher's `resolveActionParameters` walker, so JSONLogic rules referencing `{var: "<UpstreamNode>.<field>"}` produce the literal value the handler echoes back. Downstream nodes reference the result via `{var: "<NodeName>.values.<key>"}`. Spec line 41: formatters are `formatter_*` operationIds.Changes data
get_account_erasure_outcomeRead a deleted member's durable erasure outcome and notice-delivery state. Requires admin or owner.Read-only
get_account_mail_client_settingsThe caller's IMAP, SMTP-submission and CalDAV settings as data — the same username, hosts and ports the `.mobileconfig` encodes, for a mail client no Apple profile covers. Hosts come from `@ambiguous/topology`, so no client carries a hostname literal. Gated exactly like the profile: 400 when the account has no Ambiguous password or no resolvable workspace address, because either makes the settings unusable.Read-only
get_activityGet a single activity by ID. Useful for reading back a just-created activity via the resource URL in the activity.created event payload.Read-only
get_calendarGet a single calendar by ID. Returns the calendar's name, color, timezone, default status, and owner. Use this when the user asks about a specific calendar's settings or before creating events to verify the timezone.Read-only
get_calendar_colorsGet the available color palette for calendars and events. Returns 24 calendar colors and 11 event colors, each with a background and foreground hex value. Use this when the user asks what colors are available, or before setting a calendar or event color.Read-only
get_canvasGet a full canvas by id, including every element in `data.elements`. Use when you need the complete board; for a large board prefer get_canvas_manifest (ids/types/bounds only) or get_canvas_frame to stay within context budget. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas({ id: "<boardId>" }) → the board with all elements.Read-only
get_canvas_elementsUse to refresh changed elements: ids is comma-separated, max500; returns only requested members. An absent requested id is deleted—drop it locally. Coordinates: board units, top-left origin, +x right/+y down. Example: get_canvas_elements({id:"<boardId>", ids:"el-a, el-b"}) returns only surviving elements. HTML embed markup appears as html only for one requested id; multi-id, whole-board and manifest reads omit markup. With canvas_embeds off, the single HTML read returns 404 module_unavailable; ordinary element reads omit html.Read-only
get_canvas_frameGet a frame (or swimlane) element and its children — every element whose `frameId` points at it. Use to read one region of a large board in full detail. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas_frame({ id: "<boardId>", frameId: "<frameId>" }) → { frame, elements: [...] }.Read-only
get_canvas_manifestGet a bounded manifest of a board — element ids, types, and bounds only (no style/content). Use this to survey a large board cheaply, then fetch a specific frame or the full board for detail. Coordinates: board units, top-left origin, +x right / +y down. Example: get_canvas_manifest({ id: "<boardId>" }) → { element_count, elements: [{ id, type, x, y, w, h }] }.Read-only
get_channel_messagesGet recent messages from a chat channel. Returns messages with id, content (Markdown), author info, reactions, thread reply count, and timestamps. Use this when the user asks to read messages, catch up on a channel, or find a specific conversation. If the user is currently viewing a channel, use the channel ID from the page context. Messages are returned in reverse chronological order (newest first).Read-only
get_channel_read_receiptsGet per-member read positions for a channel — who has read up to which message. Useful for reporting on whether an announcement has been seen by everyone.Read-only
get_chat_link_previewsGet whether preview cards render under chat messages for the caller (`show_link_previews: true`, the default). The setting is the caller's own; it never changes what other people see or the sender's per-message preview size.Read-only
get_contactGet a single CRM contact by ID, including full details: name, email, phone, title, company, lifecycle stage, custom properties, and timestamps. If the user is currently viewing a contact, use the contact ID from the page context.Read-only
get_contact_scoreGet a contact's current lead score with a breakdown of which scoring rules matched and how many points each contributed. Use this to explain why a contact is hot/cold.Read-only
get_cover_thumbnailGet the PNG thumbnail bytes for the first slide (cover image) of a presentation. Convenience endpoint — equivalent to get_slide_thumbnail with index 0. A render with an exhausted transient image read has no ETag and Cache-Control:no-store; deterministic placeholders keep their validator. A busy renderer answers 503 slide_thumbnail_capacity_exceeded with Retry-After.Read-only
get_crm_analyticsGet analytics for accessible deals, optionally scoped to one pipeline: pipeline value by stage, conversion rates, average deal size, sales velocity, and deals breakdown.Read-only
get_crm_metricsGet pipeline metrics summary: total open deals, total deal value, win rate, deals won/lost, and recent activity counts. Useful for high-level pipeline health questions.Read-only
get_crm_reportsGet CRM revenue, deals-by-source, pipeline-by-owner, and activity reports for accessible records, optionally scoped to one pipeline. Each report preserves its own timestamp axis.Read-only
get_current_workspaceGet the active workspace (name, slug, logo, scheduling timezone). Accessible to any authenticated user.Read-only
get_data_connectorGet a single data connector by ID, including its config and last-run status.Read-only
get_dealGet a single CRM deal by ID, including full details: title, amount, currency, stage, pipeline, contact, company, owner, probability, close date, custom properties, and timestamps. Pass embed=line_items to include the full line-items array. If the user is currently viewing a deal, use the deal ID from the page context.Read-only
get_deal_templateGet a single deal template with its line items and resolved pipeline/stage names.Read-only
get_docs_page_layout_defaultGet the caller's default layout for new Docs: `pageless_default: true` (the default) means new Docs start pageless, `false` means they start in pages.Read-only
get_documentGet a single document by ID, including its full content and comments. If the user is currently viewing a document, use the document ID from the page context.Read-only
get_document_footnotesGet the footnotes from a document. Returns an array of footnotes, each with a footnoteId, body content (PM JSON), and the positions of inline references (footnoteRef nodes) in the body text.Read-only
get_document_headers_footersGet the default, first-page, and even-page headers and footers from a document as ProseMirror JSON nodes (or null if not set).Read-only
get_document_page_styleGet the page-level formatting for a document: margins (in PT), page size (letter/A4/legal or custom {width, height} in PT), and orientation (portrait/landscape). Empty object means default formatting.Read-only
get_drive_storageGet Drive storage usage.Read-only
get_drive_storage_breakdownStorage breakdown by file type.Read-only
get_emailGet a single email by ID, including full Markdown body, sender, recipients (to/cc/bcc), subject, and timestamps. Use this when the user wants to read an email, see its contents, or reply to a specific message. If the user is currently viewing an email, use the email ID from the page context. Use detail='headers' for envelope fields only (no body), or 'minimal' for id + labels only.Read-only
get_email_attachment_urlGet an attachment download URL: signed in cloud storage, authenticated API content in local storage.Read-only
get_email_calendar_inviteGet calendar invite embedded in an email.Read-only
get_email_deliverabilityGet email deliverability statistics (sent/bounced/complained/opened rates) for the past 30 days. Requires admin role.Read-only
get_email_opensFetch open events for an email (sender only) Returns the rollup (first/last seen, open count) plus up to the most recent 50 individual open events. 403 if the caller doesn't own the email's mailbox.Read-only
get_email_signatureGet the workspace default email signature (Markdown). Requires admin role.Read-only
get_entity_previewLook up a hover-card style preview of any referenced entity (document, task, contact, deal, channel, chat message, user, event, file, wiki page, form, email). Module keys include `docs`, `tasks`, `channels`, `messages`, `users`. Returns rich details — title, status, owner, due date, amount, etc. — without fetching the full record. Use this when an entity is referenced by ID and you need a quick summary.Read-only
get_eventGet a single calendar event by ID, including full details: title, description, location, start/end times, recurrence rule, status, visibility, and attendees with RSVP status. For a recurring master, occurrence_start_at selects an occurrence by its original recurrence instant, retaining a saved occurrence's own ID after rescheduling. If the user is currently viewing an event, use the event ID from the page context.Read-only
get_event_instancesList individual occurrences of a recurring event within a date range. Expands the RRULE server-side and returns instance objects with computed start/end times. Use this to find specific occurrences (e.g., 'what meetings are on next Tuesday?') or to list upcoming instances of a series.Read-only
get_feedbackRead back one submission by its receipt. Answers only the submitter — anyone else, including other members of the submitter's workspace, gets 404. Returns the public projection: a status word (`filed` | `accepted` | `declined` | `shipped`, derived from the task Ambiguous works), the title, the priority, the task key, and timestamps. Nothing else on the task is exposed.Read-only
get_file_infoGet detailed information about a file or folder in Drive. Returns id, name, mime_type, size_bytes, storage_key, owner info, parent folder, and timestamps. Use this when the user asks about a specific file's details, size, type, or location. If the user is currently viewing a file in Drive, use the resource ID from page context.Read-only
get_formGet a form's full details including field schema, settings, publish status, and slug. Use this when the user asks about a form's fields, structure, or configuration. If the user is currently viewing a form, use the resource ID from page context.Read-only
get_form_ab_analyticsGet A/B test comparison analytics for a form with variants. Returns control + each variant with views, responses, completion rate, and traffic weight. Use when the user asks which variant is winning, for A/B test results, or experiment performance comparison.Read-only
get_form_analyticsGet analytics for a form: total views, total responses, completion rate, average completion time, responses-by-day (last 30 days), per-field drop-off funnel, and per-field summaries (option counts for select fields, numeric stats for rating/number fields). Use when the user asks about form performance, response rate, completion rate, or field-level statistics.Read-only
get_form_responseGet a single form response by ID. Returns respondent info, submitted data (keyed by field ID), and timestamp. Use when the user asks about a specific submission or wants to review a particular response.Read-only
get_mail_approvalRead one submitted email exactly as it will send — From, Reply-To, the complete To/Cc/Bcc set, subject, body with signature applied, attachment manifest, threading and requested schedule. A caller without access gets 404, never 403.Read-only
get_mail_approval_attachment_urlPresigned URL for one frozen attachment, addressed by its position in the manifest. The bytes are the copy taken at submit time, so a later edit of the source Drive file does not change what the reviewer reads. The URL is minted only after the review access check.Read-only
get_mail_ruleGet one mail rule's conditions and actions by id.Read-only
get_mail_rule_applicationRead progress, the first page and count of field conflicts, and the server undo_until for your own rule application.Read-only
get_mail_rule_changesetRead your rule-management receipt, Undo deadline and reported conflicts.Read-only
get_mail_signatureGet the effective email signature.Read-only
get_mail_templateGet one saved mail template by id.Read-only
get_mail_threadGet all emails in a thread + muted flag.Read-only
get_message_readersList the users who have read a specific message (i.e. whose read-cursor is at or past this message). Use this to check whether a message (e.g. an important announcement) has been seen by specific people.Read-only
get_my_access_requestWhether you have an open access request for a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar, task, project, or CRM pipeline.Read-only
get_notification_keywordsGet the current user's notification keywords. The user receives a mention-style notification whenever any of these words appears in a message they can read.Read-only
get_ooo_statusCheck out-of-office status for one or more users. Returns per-user OOO flag and event details when applicable. Call this before scheduling to avoid inviting people who are OOO.Read-only
get_pipelineGet a single CRM pipeline by ID with its ordered stages and its `visibility` — `workspace` when the pipeline is shared with the whole workspace, `private` when only its members reach its deals. A caller who is not a member receives 404.Read-only
get_presentationGet a presentation's full data including all slides and their elements. Returns the `SlideDeck` envelope: top-level metadata (id, title, slide_count, owner, visibility, timestamps) plus the structured deck body nested under `data` (see `SlideDeckData`). Read settings/slides/masterSlides as `response.data.slides[…]`, not at the response root. If the user is currently viewing a presentation, use the presentation ID from the page context.Read-only
get_productGet one CRM product from the catalog by id.Read-only
get_projectGet a single project by ID, including task count, visibility, and metadata.Read-only
get_quoteGet a single CRM quote with its line items and linked deal/contact/company/owner.Read-only
get_read_receipts_defaultGet read-receipts default for new compose.Read-only
get_scheduler_linkGet a single scheduler link (owner-scoped) with its settings and booking count.Read-only
get_security_settingsGet workspace security settings (require_2fa, session_timeout_hours, password_min_length, ip_allowlist). Requires admin role.Read-only
get_sequenceGet a single sequence with its full step list and current enrollment count.Read-only
get_settingsGet all workspace settings. Requires admin role.Read-only
get_shared_driveGet shared drive details.Read-only
get_sheetGet a spreadsheet's structured data including columns, rows, and formulas. Returns the `Sheet` envelope: top-level metadata (id, title, owner, visibility, timestamps) plus the structured sheet body nested under `data` (see `SheetData`). Read the tab list as `response.data.sheets`; columns and rows are under `response.data.sheets[0]`, not at the response root. If the user is currently viewing a sheet, use the sheet ID from the page context.Read-only
get_sheet_rangeUse to read a rectangular slice, max 10,000 cells. Returns 2D values and resolved start/end letters+rows; orientation=COLUMNS yields column-major inner arrays. valueRenderOption: STORED(default) preserves raw values/formula strings; FORMULA forces formulas; EVALUATED runs server engine (SUM(A1:A3)→6). Cross-tab Sheet2!A1 resolves; cross-document IMPORTRANGE returns#REF!.Read-only
get_sign_auditGet the append-only audit trail for a visible signing document.Read-only
get_sign_documentGet a signing document with signers and fields.Read-only
get_slide_thumbnailGet the PNG thumbnail bytes for a specific slide. Sizes: small (200px), medium (800px, default), large (1600px). A render with an exhausted transient image read has no ETag and Cache-Control:no-store; deterministic placeholders keep their validator. A busy renderer answers 503 slide_thumbnail_capacity_exceeded with Retry-After.Read-only
get_snooze_presetsGet the user's custom snooze quick-presets. Returns defaults when no custom presets are saved.Read-only
get_swipe_actionsGet the caller's own mail-row swipe actions. Returns the defaults (right archive, left trash) when nothing is saved.Read-only
get_taskGet a single task by ID, including full details: title, description, status, priority, assignee, due date, labels, and subtask count.Read-only
get_task_permissionsRead the caller's task editing, project-move and sharing permissions, with editable IDs for the first 200 immediate subtasks.Read-only
get_teamGet details of a single team including its first 10 members. Returns team metadata (name, slug, visibility, join policy, email) and an embedded members list with each member's user_id, display_name, email, role, and added_at. Use this when the user asks about a specific team, its members, or 'who is in team X?'.Read-only
get_undo_send_settingGet undo-send duration preference.Read-only
get_unread_countsGet the full unread projection (mail inbox, per-channel chat badges with mute/preference resolved, notifications, total). Used for cold-connect / reconnect hydration; live updates arrive on the mux `unread` channel.Read-only
get_usage_statsGet workspace usage statistics including storage breakdown by user and module, active user count, API call volume, and per-module adoption metrics. Requires admin or owner role. Use this when the user asks about workspace usage, storage consumption, billing metrics, or capacity planning.Read-only
get_user_presenceGet online status (true = online within the last 5 minutes) for a set of users in the current workspace. Returns user_id → boolean. Capped at 100 user IDs. Fallback/cold-hydrate surface only — the primary presence path is the full-state push over the `presence` /ws/mux channel; poll this on connect or when the socket is down, not on a steady timer.Read-only
get_user_statusGet the current user's active chat status (emoji + text) and DND-until timestamp. Use this before setting or clearing the status to know the current state.Read-only
get_vacation_settingsGet vacation auto-reply settings.Read-only
get_wiki_database_rowGet a single database row by id.Read-only
get_wiki_pageGet a wiki page's full details including Markdown content, child pages, backlinks (pages that link to this page), and metadata. Use this when the user asks about a page's content, wants to read documentation, or needs to check what links to a specific page. If the user is currently viewing a wiki page, use the resource ID from page context.Read-only
get_wiki_page_versionGet a wiki page version's full content (title + markdown body). Use this when the user asks what a previous version looked like, wants to compare versions, or needs the content of a specific snapshot.Read-only
get_wiki_space_graphGet backlink graph data for a wiki space. Returns nodes (pages) and edges (links between pages). Use this when the user asks to visualize the knowledge graph, see how pages connect, or find highly-linked 'hub' pages.Read-only
get_wiki_synced_blockGet a synced block by ID. Returns the block's content and metadata. Use this when you need to read the current content of a shared block.Read-only
get_workspaceGet the current workspace details (id, name, slug). Requires admin role.Read-only
grant_accessGranting by email sends the recipient a notification email. Share a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar with exactly one user_id or named team_id (workspace members/teams), or email (anyone). For all current/future workspace humans and agents use set_visibility(visibility=workspace, workspaceRole), not per-person grants or the Everyone entry. message applies only to email. Unsupported roles are rejected; re-sharing cannot lower a live grant.Destructive
group_slide_elementsGroup existing top-level elements on a slide into a single group. The group's bounding box is computed automatically from the children. Children positions become relative to the group origin. At least 2 element IDs required. A named element may itself be a group — `groupElements` validates only that each id is top-level on the slide, so groups nest.Changes data
insert_page_breakInsert a page break into a document at a given position. Forces subsequent content to start on the next page in exported .docx and .pdf files. The page break is inserted as a block node between paragraphs.Changes data
insert_page_numberInsert a page number placeholder into a document. The placeholder renders as the current page number in exported .docx and .pdf files. Commonly used inside headers or footers (e.g., 'Page X') but can also appear inline in the body text. The placeholder is inserted as an inline node within a paragraph.Changes data
insert_section_breakInsert a section break into a document at a given position. Section breaks divide the document into sections that can have different formatting. A 'next_page' section break forces content to the next page (like a page break but marks a new section). A 'continuous' section break starts a new section on the same page.Changes data
leave_resourceRemove your own direct grant on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. The owner cannot leave. Returns an undo_token that shared_with_me_undo_leave accepts for ten minutes.Destructive
list_accessList named/team grants, workspace/link tiers and pending invitations for a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. id names the resource; grant IDs name recipients. To remove broad access but keep explicit collaborators and their roles, use set_visibility(visibility=restricted). The Everyone entry mirrors workspace access, not a named share. Resource kind is inferred from id.Read-only
list_activityList recent workspace activity (last 30 days). Scoped to the current user's workspace. Filterable by resource type, resource ID, and acting user. File activity uses current file view authority for data and totals. A file cohort above the activityFileCandidateMax platform limit returns 503 activity_scope_too_large; narrow by resource_id or user_id.Read-only
list_address_bookList the caller's address book: the shared CRM contacts they can see unioned with their own privately captured addresses, deduplicated on email with the shared record winning. Use this to resolve a recipient the user has written to before instead of asking them to retype an address. Private entries are never visible to another member.Read-only
list_archived_threadsList archived threads (one per thread)Read-only
list_blocked_sendersList all blocked senders for current user's mailboxRead-only
list_calendar_eventsList events scoped to a single calendar by its id — the RESTful path variant of list_events (`/api/calendars/events?calendar_id=…`). Requires at least viewer access to the calendar.Read-only
list_calendarsList the user's calendars. Returns calendar id, name, color, timezone, and whether it's the default. Use this to find the user's default calendar ID before creating events.Read-only
list_channelsList the user's chat channels. Returns channels with id, name, type (public/private/dm), description, member count, and creator info. Use this when the user asks to see their channels, find a specific channel by name, or when you need a channel ID to send a message.Read-only
list_chartsList every chart across every tab of the sheet. Each entry is annotated with the `tab` name it lives in.Read-only
list_conditional_formatsList all conditional formatting rules on a spreadsheet. Returns each rule's ID, ranges (A1 notation), and one canonical rule payload.Read-only
list_contact_activitiesList activities (notes, calls, emails, meetings, tasks) on a specific contact's timeline. Useful for summarizing recent interactions with a contact before sending an email or making a call.Read-only
list_contact_group_membersList all contacts that are members of a contact group. Returns the contact id, name, email, and type for each member.Read-only
list_contact_groupsList all contact groups in the workspace with their member counts. Groups are named collections for organizing contacts (e.g., 'Conference leads 2026').Read-only
list_contactsList CRM contacts. Supports filtering by type, lifecycle stage, owner, and text search. Returns contacts with id, name, email, phone, type, lifecycle_stage, company, and timestamps. Use this when the user asks to see their contacts, find a person, or list companies. Also use this with the 'q' parameter to search for existing contacts BEFORE creating new ones to prevent duplicates.Read-only
list_crm_activitiesList recent CRM activity visible to the current user across contact and deal timelines.Read-only
list_crm_lifecycle_stagesRead the workspace People lifecycle registry, including archived stages. An unconfigured workspace uses the seven default stages.Read-only
list_crm_property_definitionsList the workspace's typed custom-property definitions for contacts and deals, including relation properties that link a record to another contact, company, or deal. Optionally filter by entity_type.Read-only
list_crm_viewsList the user's saved CRM views (filter + sort presets for contacts/companies/deals). Views personalize how CRM data is displayed without changing the underlying records.Read-only
list_crm_workspace_usersList all users (humans and agents) in the current workspace who can own CRM records. Use before assigning contacts or deals to a specific owner_id.Read-only
list_custom_emojisList all custom emojis uploaded to the current workspace. Returns each emoji with id, name (without colons), image URL, and creator info. Use this to discover what custom emojis are available before referring to them by name.Read-only
list_data_connector_run_historyList recent execution history for a data connector. Each row records one manual or scheduled run with its status, duration, row count, and error (if any). Use the `limit` query param to cap the page size (default 20, max 100). Results are ordered by completion time, newest first.Read-only
list_data_connectorsList data connectors registered on a sheet. Connectors fetch data from external sources (URL, CSV, etc.) into specific cells.Read-only
list_deal_line_itemsList all line items for a deal, plus the computed total.Read-only
list_deal_templatesList deal templates in the workspace (reusable deal presets: default pipeline, stage, amount, probability, and line items).Read-only
list_dealsList CRM deals. Supports filtering by pipeline, stage, and status. Returns deals with id, title, amount, currency, stage, pipeline, contact, status, and timestamps. Use this when the user asks to see their deals, check the pipeline, or find opportunities.Read-only
list_document_suggestionsList pending suggestions and opaque complete-occurrence targets at the current content hash. Requires owner or editor access.Read-only
list_documentsList the current user's documents in the authenticated current workspace. Optionally filter by type. Documents the user owns in another workspace are listed only with `scope=account`; `scope=workspace` also includes documents shared in this workspace with the user's other account identities.Read-only
list_draftsList the unsent draft emails in this mailbox.Read-only
list_drive_foldersList only folders (not files) in Drive — useful for folder pickers. Pass root to scope the listing to My Drive, shared drives, or Shared with me.Read-only
list_email_attachmentsList attachments for an emailRead-only
list_enrollment_eventsGet the event log for a single sequence enrollment (step-executed, email-opened, email-replied, branch-taken, completed). Useful for auditing why a contact moved to a particular step.Read-only
list_event_resourcesList resources currently booked for an event (rooms, equipment).Read-only
list_eventsList calendar events across all of the user's calendars. Supports filtering by date range, calendar, and free-text search. Returns events with id, title, start/end times, location, status, and attendees. Use this when the user asks to see their schedule, upcoming meetings, or events for a date. Use the q parameter to search for events by keyword (matches title, description, location, and attendee names).Read-only
list_feedbackList the caller's own submissions, newest first, as public projections (see `get_feedback`). Paginated with `limit` (default 50) and `offset`.Read-only
list_filesList files and folders in the user's Drive. Returns items with id, name, mime_type, size_bytes, is_folder, parent_folder_id, owner info, and timestamps. Use this when the user asks to see their files, browse a folder, find a specific file, or check what's in Drive. If the user is currently viewing Drive, use context for the current folder. A `parent_id` the caller cannot view answers 404, exactly as an absent folder does; a folder shared from another workspace is browsed through `GET /api/drive/{id}/children` instead.Read-only
list_folder_childrenList the direct children of one folder, named in the path. Use this to browse into a folder — including one shared with you from another workspace, which the `parent_id` form of the list endpoint cannot return. Answers 404 for a folder the caller cannot view, exactly as an absent one does.Read-only
list_form_responsesList responses submitted to a form. Returns responses with respondent info, submitted data (keyed by field ID), and timestamps. Use this when the user asks to see form results, check submissions, analyze feedback, or export response data.Read-only
list_form_variantsList A/B test variants for a form. Returns each variant's id, name, traffic weight, active status, and variant form ID. Use when the user asks about their A/B tests, variant list, or experiment setup.Read-only
list_formsList the user's forms. Returns forms with id, title, slug, is_published, response count, timestamps, and the caller's own star and Drive tags. Pass `starred=true` for only the forms you starred. Use this when the user asks to see their forms, find a specific form, or check form status.Read-only
list_forwarding_addressesList forwarding addresses + recent log.Read-only
list_inboxList the user's received emails (inbox). Returns emails with id, from, subject, preview, read status, and sent timestamp. Use this when the user asks to check their inbox, see recent emails, or find a specific email. Use detail='headers' for bandwidth-efficient scanning (omits body), or 'minimal' for id + labels only. Use label_ids to filter by specific labels (AND semantics — all listed labels must be present).Read-only
list_mail_approvalsList email submissions awaiting a human decision. Returns the caller's own submissions plus the ones they may decide — as the submitting agent's current manager, or as a workspace admin/owner. A former manager sees nothing.Read-only
list_mail_by_labelList emails with a specific labelRead-only
list_mail_labelsList every mail label in this mailbox.Read-only
list_mail_rule_application_conflictsPage the message fields a restoration left alone because they changed after the rule applied.Read-only
list_mail_rulesList mail rules / filters.Read-only
list_mail_templatesList the saved mail templates in this mailbox.Read-only
list_muted_threadsList muted threads (inbox view for muted conversations)Read-only
list_my_teamsList teams the current user belongs to, with their role (admin or member) in each. Use this when the user asks 'what teams am I in?' or 'my teams' or 'my memberships'.Read-only
list_my_workspacesList workspaces the current user belongs to (human users may have multiple). Returns workspace id, name, slug, role, and which one is active.Read-only
list_named_rangesList named ranges and named expressions on a spreadsheet. Each entry returns its name and either an A1 range or an exact literal expression. External-workbook expressions remain unresolved.Read-only
list_pinned_messagesList all pinned messages in a channel. Pinned messages are highlighted by members for ongoing reference (announcements, canonical links, etc.). Returns messages in newest-pin-first order.Read-only
list_pipeline_membersList the members of a CRM pipeline. Deal visibility is pipeline membership: a deal is visible to admins/owners and to members of its pipeline (directly or via a team). Roles are admin (can manage the pipeline + members) or member.Read-only
list_pipelinesList all CRM pipelines with their stages. Each pipeline contains an ordered list of stages with names, sort order, and default probabilities. Use this before creating or moving deals to find valid pipeline_id and stage_id values.Read-only
list_pivot_tablesList every pivot table across every tab of the sheet. Each entry is annotated with the `tab` name it lives in.Read-only
list_productsList products in the workspace catalog. Use this when the user asks about pricing or available SKUs, or before adding a product as a deal line item.Read-only
list_project_updatesList status updates for a project, newest first. Returns the health timeline with author and timestamp.Read-only
list_projectsList accessible projects in the current workspace, optionally filtering by a case-insensitive name query before pagination. Returns each project with name, icon, color, visibility, and task count. Use this when the user asks to see their projects or find a project by name.Read-only
list_protected_rangesList all protected ranges on a spreadsheet. Returns each range with its ID, A1 range, description, warningOnly flag, and editorUserIds allowlist.Read-only
list_quotesList CRM quotes/proposals. Filter by status (draft, sent, accepted, rejected, expired), deal, or contact. Useful for finding outstanding quotes or recently-accepted ones.Read-only
list_resource_commentsRead comments on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. Resource type is resolved from ID; a mail conversation can use its thread key with mailbox_id. Every container returns the same comment model: roots with their replies, the caller's capabilities on each, and unread counts.Read-only
list_resourcesList bookable resources (rooms, equipment) in the workspace. Call before booking a room to see what's available.Read-only
list_rolesList all roles in the workspace (system roles + custom roles). Requires admin role.Read-only
list_saved_messagesList all messages the current user has saved (bookmarked) across all channels. Returns messages with saved_at timestamp, channel name, and channel type. Saved messages are private to the current user (unlike pinned messages, which are shared with the channel).Read-only
list_scheduled_mailList scheduled (unsent) emailsRead-only
list_scheduled_messagesList all pending scheduled messages for the current user across all channels. Returns each scheduled message with channel name/type and the scheduled_at timestamp. Use this to review what's queued to send later, or before updating/cancelling a scheduled message.Read-only
list_scheduler_bookingsList all bookings (across all scheduler links) owned by the current user. Useful for summarizing the user's upcoming meetings.Read-only
list_scheduler_link_bookingsList all bookings for a single scheduler link (owner-scoped).Read-only
list_scheduler_linksList the user's scheduler links (Calendly-style booking pages). Each link has a shareable slug, duration, availability hours, and optionally auto-creates a contact + deal when booked.Read-only
list_scorable_fieldsList the contact fields that can be used in scoring rules (lifecycle_stage, industry, title, website, custom_properties.*, etc.) and the operators each supports.Read-only
list_scoring_rulesList all lead scoring rules for the workspace.Read-only
list_send_as_addressesList available send-as addresses for current userRead-only
list_sent_mailList the emails sent from this mailbox.Read-only
list_sequence_enrollmentsList all enrollments for a sequence, including each contact's current step, status, and next execute time. Useful for checking progress or finding an enrollment ID to unenroll.Read-only
list_sequencesList all CRM email/task sequences (multi-step automated outreach campaigns). Returns sequences with their steps, active status, and current enrollment count.Read-only
list_shared_drive_filesList files in a shared drive.Read-only
list_shared_drive_membersList shared drive members.Read-only
list_shared_drivesList shared drives user is a member of.Read-only
list_sheet_imagesList editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.Read-only
list_sheet_picture_groupsList editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.Read-only
list_sheet_shapesList editable floating shapes with editable text, cell anchors and CSS pixel geometry.Read-only
list_sheet_tablesList editable table definitions by worksheet.Read-only
list_sheet_validationsList all data validation rules on a spreadsheet. Returns each rule's range (A1 notation) and rule definition (type, values, strict, inputMessage).Read-only
list_sheetsList the current user's spreadsheets (owned + shared). Convenience alias for `GET /api/documents?type=sheet`. Returns the lightweight `SheetSummary` shape without the structured `data` body — call `GET /api/sheets/:id` to load a specific sheet's tabs/columns/rows.Read-only
list_sign_documentsList signing documents in the workspace.Read-only
list_sign_templatesList reusable signing templates.Read-only
list_slicersList every slicer across every tab of the sheet. Slicers are interactive filter widgets that filter pivots / charts on a shared source range. Each entry is annotated with the `tab` name it lives in.Read-only
list_slide_mastersList the master slide templates registered on a presentation. Child slides link to masters by reference and resolve current master elements at render time, beneath child-owned elements.Read-only
list_snoozed_mailList the snoozed emails in this mailbox.Read-only
list_sparklinesList editable sparklines and their owning worksheet.Read-only
list_starred_mailList the starred emails in this mailbox.Read-only
list_table_stylesList workbook custom table styles.Read-only
list_task_attachmentsList task-owned attachments and existing legacy attachments.Read-only
list_task_templatesList task templates in the workspace. Templates pre-fill fields when creating tasks. Optionally filter by project. Returns name, default fields (priority, status, estimate, assignee, labels), and creator.Read-only
list_tasksList tasks in the workspace. Pass assignee_id to filter by assignee (use the caller's user ID for 'my tasks'). Supports filtering by status, priority, project, and free-text query. Defaults retain full content and aggregates. Use fields= for sparse rows and include_counts=false on cursor continuation pages to avoid repeated aggregate work.Read-only
list_teamsList workspace teams visible to the current user. Returns public teams and private teams the user is a member of, with member counts. Filterable by `q` (case-insensitive substring match on name + slug). Optional `limit` caps the result count. Use this when the user asks to see teams, distribution lists, or workspace teams.Read-only
list_trashed_filesFind deleted Drive file rows and folders the caller owns, trashed themselves, or holds the owner rung on (a folder above it is theirs, or they manage its shared drive). Returns paginated file IDs and metadata for restore_file or permanent_delete_file. Can include materialized native-document shadow rows, but does not list every native Docs, Sheets, Slides or Canvas item: use documents_trash_list for the complete native-document trash owned by the caller. An empty result does not mean the whole workspace trash is empty.Read-only
list_user_statusesList active chat statuses (emoji + text + DND) for users in the workspace. Only returns users who currently have a non-null status or active DND. Useful for 'who's on vacation?', 'is anyone in meetings?', or similar presence queries.Read-only
list_usersList workspace members and agents with identity, role, status, storage usage, and timestamps. Requires admin or owner.Read-only
list_wiki_page_databasesList all inline databases hosted on a wiki page.Read-only
list_wiki_page_versionsList the saved version snapshots for a wiki page (most recent first). Use this when the user asks for revision history, wants to see who edited and when, or needs to find a version to revert to.Read-only
list_wiki_space_pagesList pages in a wiki space with offset/limit pagination. Returns page summaries (id, title, slug, icon, parent_page_id, sort_order). Use this when the user asks to see all pages in a space, or when you need to paginate through a large space.Read-only
list_wiki_spacesList all wiki spaces. Returns spaces with id, name, slug, description, icon, owner info, privacy setting, and page count. Use this when the user asks to see wiki spaces, browse the knowledge base, or when you need a space ID to create a page.Read-only
list_wiki_synced_blocks_by_pageList synced blocks that were originally created on a specific page. Use this when the user asks what shared content a page publishes, or to audit reuse.Read-only
log_activityLog an activity on a CRM contact or deal timeline. Activities track interactions like calls, emails, meetings, notes, and tasks. Use this when the user asks to log a call, record meeting notes, or add a note to a contact/deal.Changes data
mail_alias_createAdd a new alias on a verified workspace domainChanges data
mail_alias_deleteDelete a send-from alias address by id.Destructive
mail_alias_set_defaultSet alias as default send-as identityChanges data
mail_aliases_listList all aliases for current user's mailboxRead-only
mail_blocklist_clearUnblock by raw pattern (convenience for "Unblock sender" button)Destructive
mail_blocklist_removeUnblock a sender by their blocklist entry id.Destructive
mail_bulk_modifyApply one bulk action to emails chosen by id or search query.Changes data
mail_export_emlExport a message as RFC 5322 EML, returning retained source octets when available.Read-only
mail_external_auth_urlStart connected-mailbox (Gmail) OAuth — returns the consent URL.Read-only
mail_external_connection_deleteDisconnect a connected mailbox.Destructive
mail_external_connection_testVerify a connected mailbox by fetching its Gmail profile.Read-only
mail_external_connections_listList connected mailboxes.Read-only
mail_folder_countsPer-folder badge counts for sidebar Returns { inbox: unread_count, drafts, scheduled, snoozed } — Gmail-style.Read-only
mail_label_countsPer-label unread counts for sidebar badges. A separate endpoint so the sidebar can refresh counts on read/receive without re-fetching the label definitions themselves. Shape mirrors /folder-counts.Read-only
mail_message_unsubscribeOne-click unsubscribe. Triggers the List-Unsubscribe URL (RFC 8058) on the user's behalf. Falls back to telling the client to open a mailto: link if no HTTP URL is present.Destructive
mail_shared_mailbox_assigneesThe people who can hold a thread in this shared mailbox — team grants flattened to their members.Read-only
mail_shared_mailbox_createCreate a shared mailbox and address it on a workspace domain (admin only)Changes data
mail_shared_mailbox_deleteRetire a shared mailbox (admin only). Soft: stored mail is retained and the address stays reserved.Destructive
mail_shared_mailbox_getGet one shared mailbox and its membersRead-only
mail_shared_mailbox_member_addGrant a user or a team access to a shared mailbox (admin only)Changes data
mail_shared_mailbox_member_removeRevoke a user's or team's access to a shared mailbox (admin only)Destructive
mail_shared_mailbox_restoreRestore a retired shared mailbox (admin only). Total — delete cascaded nothing.Changes data
mail_shared_mailbox_updateRename a shared mailbox's display name; its address is unchanged (admin only)Changes data
mail_shared_mailboxes_listList the shared mailboxes the caller holds, or every one in the workspace with `scope=managed` (admin only)Read-only
mail_smart_composeSuggest a short continuation of an email draft being written. Takes the text typed so far, optionally the subject and the earlier messages of the thread being replied to, and streams the suggested next words.Changes data
mail_thread_mute_statusCheck if a thread is mutedRead-only
mail_trash_listList trashed (soft-deleted) emails — the caller's own rows in folder='trash'. Restore one with `untrash_email`; nothing is purged automatically.Read-only
mail_unread_summaryUnread mail summary for a cross-module unread view: the total unread count plus the top N (default 5, max 25) unread inbox rows with sender, subject, preview and timestamp, so a unified list can render without pulling the full inbox.Read-only
map_mail_search_to_ruleMap supported search terms to conditions and name every omitted restriction. Preview changes nothing.Read-only
mark_all_channels_readMark all channels as read for the current user. Advances the read cursor in every channel the user is a member of to the latest message, clearing all unread badges at once. Use this when the user wants to dismiss all chat unreads (e.g. returning from vacation).Changes data
mark_channel_readMark a channel as read up to a specific message. This clears the unread badge for the current user. Use this after the user has finished catching up on a channel, or programmatically to dismiss unread counts after the assistant reports on recent messages.Changes data
mark_channel_unreadMark a channel as unread starting from a specific message. Moves the calling user's read cursor back to just before that message, so the channel shows an unread badge and the message becomes the unread boundary. Use this when the user wants to revisit a conversation later.Changes data
mark_email_readUpdate email status (read/unread, starred, snoozed)Changes data
mark_resource_comments_readMark every comment thread on a document, Drive file, task, wiki page, mail conversation, pull request, or code review read for yourself. Resource type is resolved from ID; a mail conversation can use its thread key with mailbox_id. Idempotent; read state is private.Changes data
mark_thread_readMark a thread as fully read up to the latest reply. Use this after the user has finished catching up on a thread, or when you want to programmatically dismiss unread reply counts for a specific thread.Changes data
mark_thread_unreadMark a thread as unread so it reappears in the threads inbox with an unread badge. An optional reply_id marks that reply onward unread. Omit it to mark the whole thread unread. Restore accepts the prior cursor and its expected current cursor; a newer intent returns 409.Changes data
merge_contactsMerge two CRM contacts that represent the same person/company. The secondary contact is deleted, and its activities and deals are re-linked to the primary. Use this when you discover duplicates (same email or name). The primary contact is the one kept; the secondary is removed.Destructive
migrate_document_sourceActivate source-preserving editing on an existing document. Only its owner may migrate; the expected content hash prevents stale activation and the command ID makes retries idempotent.Changes data
modify_contact_group_membersBulk add or remove contacts from a contact group. Idempotent — adding an already-present contact or removing an absent one is a no-op.Changes data
move_sheet_columnMove one or more consecutive columns to a new position. The response carries a history receipt for Undo. Rewrites dependent formulas so they follow the moved column to the same logical data, and re-anchors notes and comment anchors.Changes data
move_sheet_rowMove one or more consecutive rows to a new zero-based position, carrying its values, formatting, geometry and dependent references.Changes data
notifications_dismissSoft-delete (hide from default feed). Preserved for audit / undismiss.Changes data
notifications_listList notifications for the current user. Supports cursor pagination via `?cursor=`; legacy offset pagination still works. Filters: `resource_types`, `excluded_resource_types`, `event_types`, `unread_only`; visibility toggles: `include_dismissed`, `include_snoozed`.Read-only
notifications_mark_all_readMark every unread notification in the optional resource/event scope as read.Changes data
notifications_mark_readMark a single notification read. Returns `was_unread` — true only if THIS call flipped it. A consumer that gets `false` skips the work, so two processes on one identity cannot both act on one notification.Changes data
notifications_mark_unreadConvenience alias for `PATCH /api/notifications/:id` with `{read:false}`.Changes data
notifications_mute_createCreate or refresh your in-app/live notification suppression rule for resourceId, eventType, or both. Matching direct mentions are suppressed there too; email and push delivery are unchanged. This does not change a chat channel's mute setting or notification preference. For ordinary channel mute/unmute use set_channel_muted. At least one selector is required; resourceId also requires resourceType. until=null or omitted means indefinite. A matching rule's expiry is refreshed.Changes data
notifications_mute_deleteRemove a mute rule by id. Scoped to the owning user.Destructive
notifications_mutes_listList active mute rules. Pass `?include_expired=true` to also see rules whose `until` has passed (these no longer suppress notifications).Read-only
notifications_snoozeHide until `{until: ISO8601}`. Pass `{until: null}` to clear snooze.Changes data
notifications_undismissRestore a dismissed notification.Changes data
patch_canvas_elementUse to patch one element to move/restyle/relabel/reanchor: only changed fields; id/type fixed, others preserved. Several elements: one batch_canvas_elements call writes the board once; repeated single calls each wait on the board lock. Style replaces; style:null removes. Coordinates: board units: top-left origin, +x right/+y down; x, y move top-left. Example: patch_canvas_element({id:"<boardId>", elId:"<elId>", x:240, y:80}). Embed: sandboxed frame; interactive=false runs no scripts/forms; kind fixed; title/interactive editable. HTML single inlined UTF-8 file, 5 MB max (413 embed_html_too_large); new board asset/src, old markup in version history. src only URL kind, https required (400 embed_url_invalid otherwise; HTML src returns 400 embed_src_managed). Responses src, never markup; only get_canvas_elements with one id returns html. Embed example: patch_canvas_element({id:"<boardId>", elId:"<elId>", html:"<!doctype html><button>Pay</button>"}). canvas_embeds off: create, html/src/interactive patch, URL mint, serve, both asset markup reads 404 module_unavailable; single read omits html; move/resize/rename/lock/delete work. Portal module/targetId fixed; patch selector: docs {}, slides {slide} zero-based first default, sheets {range} A1 import-range cap, canvas {frameId}. Wrong-module/malformed/over-cap 400 portal_selector_invalid. Viewer access, target module 404; title server-written create/patch, never send. Host/portal-containing frame 400 portal_recursive; connection 400 portal_not_connectable. Resize docs480x640, slides480x270, sheets560x320, canvas560x400. Example: patch_canvas_element({id:"<boardId>", elId:"<elId>", selector:{range:"Sheet1!A1:F20"}, w:560, h:320}). canvas_portals off:selector patch 404 module_unavailable; move/resize/lock/delete work.Changes data
patch_sheet_tableChange supplied table fields only. Identity and unrelated declarations remain.Changes data
poll_closeClose a poll to further voting (creator or channel admin).Changes data
poll_createCreate a poll in a channel. Creator must be a channel member.Changes data
poll_deleteDelete a poll (creator or channel admin).Destructive
poll_getPoll details (question, options, the caller's votes).Read-only
poll_get_by_messagePoll results for the poll attached to a chat message.Read-only
poll_resultsTallied poll results (respects anonymity).Read-only
poll_unvoteRemove the caller's vote for a poll option.Changes data
poll_voteCast a vote for a poll option.Changes data
preview_mail_rulePreview the caller's received Inbox/Archive messages with the delivery matcher. Counts and pages matches within the newest candidates, showing the five newest by default. more_may_match means older messages were not read; applying the rule still covers them.Read-only
preview_mail_rule_exportReturn serialized file bytes as text plus every Gmail loss and omission; Backup preserves writable configuration, on/off and order.Read-only
preview_mail_rule_importPreview size-limited Gmail API filter JSON plus a label map or an Ambiguous backup. XML must be normalized by the browser; unsupported restrictions skip the whole filter.Read-only
project_members_addAdd a member. Body `{user_id, role?}` — or `{team_id, role?}` for a team share. A project editor may add, capped at its own role: granting a role above it is refused `403`. Notifies the new member.Changes data
project_members_listList project members.Read-only
project_members_removeRemove a grant from the project. The path id is the principal id: a user by default, or a team with `?type=team`. Notifies the removed user (unless self-removal). The Everyone team's row is refused — workspace access is set through the project's visibility, which is its only control.Destructive
project_members_update_roleChange a member's role.Changes data
project_notification_pref_getGet the caller's notification preference for the project.Read-only
project_notification_pref_setSet the caller's notification preference (`level`) for the project.Changes data
project_templates_applyCreate a new project from a template. Pass `{name, description}` in the body.Changes data
project_templates_createCreate a project template.Changes data
project_templates_deleteDelete a project template.Destructive
project_templates_getGet a single project template.Read-only
project_templates_listList project templates in the workspace.Read-only
project_updates_deleteDelete a status update. Author or admin only.Destructive
project_updates_editEdit a status update. Author or admin only.Changes data
protect_rangeProtect a range in a spreadsheet. Protected ranges restrict editing to users in editorUserIds. Set warningOnly to true for soft warnings instead of hard blocks.Changes data
publish_formPublish a form so it accepts public responses. Semantic shortcut for PATCH /api/forms/{id} with is_published=true; same validation (every field needs a non-empty label).Changes data
query_wiki_databaseQuery rows from an inline database with optional view, filter, and sort. Returns paginated results.Read-only
realtime_exchange_connection_capabilityExchange JWT/ak_ for a short-lived socket capability for caller workspace/session. No inputs: credential sets identity. Object channels require resource capabilities; API rechecks writes. Principal-rate or instance DB-admission exhaustion: 429 Retry-After.Changes data
realtime_exchange_resource_capabilityExchange credential for a short-lived capability on one requested object channel. REST object role decides authority; operations only narrows it. Unauthorized operations are refused, never clamped. Unreachable/absent object: 404. API rechecks writes.Changes data
recalculate_lead_scoresRecalculate lead scores for all contacts in the workspace. Use this after creating or updating scoring rules so existing contacts pick up the new scoring.Changes data
remove_accessRemove a named grant, pending invitation or link access on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. Give exactly one user_id, team_id, pending_share_id (unaccepted invitation), or link=true (restricts the link tier; unavailable on calendars). To remove broad access while retaining explicit collaborators use set_visibility(visibility=restricted), not Everyone removal.Destructive
remove_forwarding_addressRemove a forwarding addressDestructive
remove_pipeline_memberRemove a user or team from a CRM pipeline. The principalId is the user_id or team_id of the member to remove.Destructive
remove_shared_drive_memberRemove a shared drive member (manager-only; cannot remove last manager).Destructive
remove_sheet_columnRemove a column from a sheet tab by column ID. Use `?sheet=` to target a tab other than the first.Destructive
remove_sheet_tabRemove a sheet tab by name. Cannot remove the last remaining tab.Destructive
remove_sheet_tableRemove a table definition while retaining its cells.Destructive
remove_slideRemove the slide at the given zero-based index.Destructive
remove_table_styleDelete an unused custom table style.Destructive
remove_task_attachmentRemove a task attachment and its owned bytes. Removing a legacy attachment leaves its original Drive file unchanged.Destructive
rename_document_versionRename a version snapshot of a document. Useful for labeling meaningful versions (e.g., "Pre-launch draft", "Board approved"). Requires editor permission.Changes data
rename_sheet_tabRename an existing sheet tab.Changes data
reorder_mail_labelsReorder the mail labels shown in the sidebar.Changes data
reorder_mail_rulesReorder the mail rules to change which runs first.Changes data
reorder_slidesReorder slides in a presentation. Provide the full list of slide indices in the desired new order. Example: [2, 0, 1, 3] moves the third slide to the front.Changes data
replace_named_range_contentReplace all content within a named range with new content. Used for template-based document generation — define named ranges as placeholders, then call this to fill each one. The named range must have positional anchors (startNodeId/endNodeId). Content can be Markdown text or PM JSON. Returns 409 if the anchored nodes no longer exist (stale range after CRDT edits).Changes data
replace_shapes_with_imageReplace text placeholder elements with an image across all slides. Finds text elements whose text matches the search string and replaces them with image elements at the same position and size. Like Google Slides ReplaceAllShapesWithImage — useful for template-based workflows where placeholder shapes like {{logo}} are swapped with actual images.Changes data
replace_sheet_tabReplace a sheet tab's columns and/or rows wholesale. Use for bulk data replacement. Use update_cells for surgical edits.Changes data
request_accessAsk the owner of a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar, task, project, or CRM pipeline for access at a role higher than any you hold. Documents, Drive items and wiki pages offer viewer, commenter and editor; forms and calendars viewer and editor; projects commenter and editor; tasks editor; pipelines member. Returns 409 while a request is already open.Changes data
reschedule_scheduled_emailChange a pending delivery time, or remove its schedule with scheduled_at:null and expected_scheduled_at to retain the message as a draft.Changes data
restore_fileRestore a file from trash. Needs the owner rung (the owner, the owner of a folder above it, or a manager of its shared drive); a caller who can see the file without it gets 403.Changes data
restore_sheet_structureUndo or redo a structural change receipt without overwriting unrelated later edits.Changes data
restore_taskRestore a soft-deleted task when the caller has task editor access.Changes data
restore_wiki_synced_blockRestore a previously deleted synced block. Embedding pages will render the block again instead of showing error chips.Changes data
retry_mail_rule_applicationResume a failed transactional job from its durable progress; committed messages are never reapplied.Destructive
revert_wiki_page_versionRevert a wiki page to a previous version snapshot. This replaces the current content with the version's content and rebuilds the page's collaborative state from it. A snapshot of the current state is automatically created before reverting. This is destructive for the in-progress edit — always confirm with the user first.Changes data
review_document_suggestionsAccept or reject selected opaque suggestion targets, or all pending suggestions, against the content hash returned by list_document_suggestions. Requires owner or editor access.Destructive
rotate_calendar_publish_urlRotate a published calendar's read-only subscription URL. The previous URL is revoked immediately.Changes data
rsvp_email_inviteRSVP to a calendar invite on an email.Destructive
rsvp_eventRSVP to a calendar event that the user is invited to. Use this when the user asks to accept, decline, or mark tentative on an event invitation.Changes data
save_messageBookmark an EXISTING chat message in the current user's private Later/saved list. Resolve the original message_id with search_chat_messages or get_channel_messages when it is not supplied. Does not post or copy a message, and does not set a timed reminder (use set_reminder for that). Saving an already-saved message is a no-op.Changes data
scan_business_cardOCR a photo of a business card and extract structured contact fields (name, title, company, email, phone, website, address, notes). Returns JSON with each field nullable when not present on the card. Use when the user uploads or references a business card image and wants to add the contact to CRM. The image must be passed as a base64 data URL (data:image/jpeg;base64,...) of an image format Gemini Vision supports (JPEG, PNG, WebP, HEIC). Max 6 MB.Changes data
search_calendar_eventsFull-text search across all calendar events for the current workspace. Returns matching events with id, title, start/end times, and calendar info. Use this when the user asks to find a specific event by name or description keyword.Read-only
search_chat_messagesFind existing chat messages by keyword, phrase, or topic across the caller's accessible channels. Results include the message id and channel context needed to bookmark, remind, react, reply, or edit that message. Use channel_id to restrict the search to a known channel; this read does not post messages.Read-only
search_mailFull-text + operator search (Gmail-style: from:, to:, cc:, bcc:, subject:, has:attachment, is:read|unread|starred, in:inbox|sent|drafts|trash|archive, label:, after:YYYY-MM-DD, before:YYYY-MM-DD, size:N, larger:N, smaller:N, "phrase"). cc:/bcc: filter by recipient type. size:/larger:/smaller: filter by body byte size.Read-only
search_paletteCross-module command-palette search — every module including chat messages. `q` is the query string; `limit` caps results (default 30, max 50). Empty query returns an empty response. Module diversity is preserved. `counts` carries the per-module match total before the per-module cap.Read-only
search_wikiCase-insensitive substring search across wiki page titles and Markdown content. Returns only pages the caller can view under the effective page-to-space permission rules, with id, title, space, and content snippets. Use this when the user asks to find information in the wiki, look up documentation, or search the knowledge base. More efficient than reading individual pages.Read-only
search_workspaceSearch across every module in the user's workspace (docs, sheets, slides, canvas, tasks, contacts, deals, channels, chat messages, wiki, forms, calendar, users, mail, files, teams, and saved Analytics reports for callers who can read them). Returns a flat list of results with module-aware metadata, plus `counts` — the per-module match total before the per-module cap. Optional module filter narrows the search to one or more modules; `sort` picks relevance or recency. Use this when the user asks to find something but you don't know which module it lives in.Read-only
send_draft_emailUse to send a saved draft. Normal delivery moves it from drafts to sent, triggers SES and creates recipient inbox copies. For a workspace-only agent, any external To/Cc/Bcc instead queues the WHOLE email for human decision; nobody receives it. Response delivery_status: pending_approval and pending_approval.review_id. Report awaiting approval, not sent; never resend. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.Destructive
send_emailUse to send email as current user: Markdown body becomes HTML; To/Cc/Bcc use email addresses. For workspace-only agents, any external To/Cc/Bcc queues the WHOLE email for a human decision; no recipient gets delivery. Response delivery_status:pending_approval with pending_approval.review_id. Report awaiting approval, never sent; do not resend. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.Destructive
send_messagePost a NEW message visible to the chat channel's members, or send a thread reply. Use for requested communication, not for finding, bookmarking, or reminding about an existing message: those actions use search_chat_messages/get_channel_messages then save_message/set_reminder on the returned message id. Content is Markdown with @mentions, code blocks, and links. Use the current channel ID when supplied by page context. To reply, set thread_id to the original parent message's id. To attach a file, upload it with drive_file_upload_proxy (source=chat) and include [name](drive://<file_id>) in content.Destructive
send_quoteSend a CRM quote via email to the contact. Marks the quote as 'sent'. By default, sends to the linked contact's email address.Destructive
send_scheduled_message_nowDeliver a pending scheduled message immediately instead of waiting for its scheduled time. Flips the message to sent and fans it out to the channel right now. Fails if the message has already been sent or cancelled. Use this when the user wants to send a queued message without waiting.Destructive
send_test_notification_emailSend a test notification email (useful for checking email rendering and deliverability). Requires admin role.Destructive
set_channel_archivedArchive or unarchive a chat channel. Archiving freezes writes for everyone. Requires the same administrative authority as the individual archive and unarchive actions.Changes data
set_channel_mutedMute or unmute a chat channel for yourself, including DMs, temporarily or indefinitely. Muting silences ordinary message, keyword and subscribed-thread alerts and removes the channel-presence badge contribution; direct mentions and broadcasts still reach you. This changes the channel mute setting, not its notification preference or a delivery-suppression rule. muted=true optionally accepts until or duration_ms; omit both for indefinite mute. muted=false cannot include timing fields.Changes data
set_chat_link_previewsShow or hide preview cards under chat messages for the caller. `false` hides both workspace entity cards and external link cards; chips and links stay in the message, and nobody else is affected.Changes data
set_comment_thread_readMark a comment thread read or unread for yourself by its root comment ID, on a document, Drive file, task, wiki page, mail conversation, pull request, or code review. read=true clears its unread badge; false keeps it flagged until reopened, even when its only comments are yours. A reply ID answers 404; marking a resolved thread unread answers 409 comment_resolved.Changes data
set_deck_fontsSet the heading and/or body font across a whole presentation: every text box, shape and table on every slide and master, group children and per-run rich-text fonts included. Text at 28px or larger takes the heading font; smaller text and tables take the body font. Fonts are a closed list. The saved deck is re-read before responding: a 409 means some elements still use another font, so the change is incomplete and must not be reported as done.Changes data
set_default_send_asSet the user's default send-as address.Changes data
set_docs_page_layout_defaultSet the caller's default layout for new Docs (`pageless_default: true` = pageless, `false` = pages). Affects only Docs created afterwards; existing Docs keep their layout.Changes data
set_document_footnotesSet footnote body content on a document. Replaces the footnoteSection with canonical footnoteItem nodes. Each footnote must have a footnoteId and either text, inline PM JSON content, or one paragraph without paragraph formatting. Bodies that cannot be represented losslessly are refused. When stored model requirements apply, send model_features covering them; missing or incomplete required capabilities are refused with 409. To add inline footnote references in the body text, use update_document with PM JSON content containing footnoteRef nodes with matching footnoteIds.Changes data
set_document_headers_footersSet default, first-page, and even-page headers and footers. Each field accepts a plain text string (auto-wrapped in a paragraph), a ProseMirror JSON node, or null to remove. Omit a field to leave unchanged.Changes data
set_document_named_stylesCreate, edit or remove typed paragraph and character style definitions with a guarded whole-registry command. Read current content first, preserve sparse native declarations and include the current content SHA-256. Explicit adoption authorizes replacing supported imported declarations; projection scope authorizes only derived style map/native carrier changes. Initial existing-document writes return a reader fence deadline; retry the same command after it drains. Concurrent stale changes refuse. The inverse registry is a new command guarded by the latest content hash. An optional restore_projections style-only preimage obeys the document body/walk limits and is accepted only when a forward replay reconstructs the current stored style projections.Changes data
set_email_archivedArchive an email or return it to the inbox. archived=true archives; false unarchives. Existing mailbox access rules apply.Changes data
set_email_signatureSet the workspace default email signature. Pass null (or omit markdown) to clear. Requires admin role.Changes data
set_mail_signatureSet personal email signature. Pass null to clear.Changes data
set_mail_thread_assigneeAssign a shared-mailbox conversation to a member, or clear its assignment with user_id=null. Does not change its folder.Changes data
set_mail_thread_mutedMute or unmute a mail conversation. muted=true moves it out of the inbox and keeps future replies muted; false restores it. mailbox_id selects a shared mailbox.Changes data
set_notification_keywordsReplace the current user's notification keyword list. Keywords are case-insensitive, whole-word, and capped at 20 entries (each up to 50 characters). Duplicates/empties are dropped. Use this when the user says 'alert me whenever someone mentions X' or 'stop notifying me about Y'.Changes data
set_pinned_header_rowsSet the number of pinned (repeating) header rows on a table in a document. Pinned header rows repeat on every printed page when the table spans multiple pages in exported .docx and .pdf files. Set to 0 to clear the pinned header rows attribute.Changes data
set_reactionAdd or remove your emoji reaction on a chat message or a comment. The target is resolved from ID. present=true adds; false removes. Existing parent visibility, workspace custom-emoji rules, broadcast-message identity, and missing-reaction errors apply. A comment returns the updated comment.Changes data
set_read_receipts_defaultToggle the default for new compose windowsChanges data
set_reminderRemind only the signed-in user about an existing chat message at a future time. A channel named in a personal reminder request locates the source message; it is not an audience or a request to post there. When message_id is unknown, first find the original with search_chat_messages or get_channel_messages; an unknown ID does not mean the message is absent. If the target cannot be identified, ask for clarification instead of publishing a replacement. Automatically bookmarks the original in Later. remind_at is an ISO 8601 datetime and must be in the future.Changes data
set_resource_starredAdd or remove favorites (star/unstar) for documents, spreadsheets, presentations, canvases, Drive items, forms, channels, teams or Wiki pages. Resource type is resolved from ID; existing starring/access rules apply. Tasks-sidebar view/project pins use tasks_favorites_add/remove instead.Changes data
set_sheet_column_typeSet a column's declared type without coercing cells. expected_type must match its current type under the document lock; null denotes absent type metadata. Conflicts return 409 without changing the workbook.Changes data
set_sheet_validationSet a data-validation rule on a spreadsheet cell range in A1 notation. Supports dropdown/range lists, numeric/text/date conditions, checkbox values, and custom formulas. Numeric constraints use JSON numbers, not numeric strings. Strict configures invalid-entry rejection rather than warnings in the editor; API cell writes do not enforce these rules.Changes data
set_snooze_presetsSet the user's custom snooze quick-presets (up to 10). Pass an empty array to reset to defaults.Changes data
set_swipe_actionsSet the caller's own mail-row swipe actions — one action per direction, chosen from archive, trash, read, star, snooze.Changes data
set_table_themeSet all twelve workbook theme colors; affects every theme-linked workbook feature. Null restores native/default palette. expected_updated_at refuses stale replacements with 409; omission deliberately replaces.Changes data
set_task_archivedArchive or unarchive a task. Archive is separate from Trash; archived=false does not restore a trashed task. Existing project and task permissions apply.Changes data
set_task_subscriptionSubscribe or unsubscribe yourself from a task's notifications. When subscribed=true, user_id may select another subscriber under the existing subscription rules; unsubscribe applies only to yourself. Subscription does not grant task access.Changes data
set_undo_send_settingSet undo-send duration (seconds).Changes data
set_user_dndEnable or disable Do-Not-Disturb for the current user. Pass an ISO-8601 timestamp in the future to snooze notifications until that time, or pass null to disable DND immediately. Use this when the user says 'mute me for an hour', 'DND until 5pm', or 'turn off DND'.Changes data
set_user_statusSet the current user's chat status — an emoji, short text (<=100 chars), and optional auto-clear timestamp. All fields are optional; pass null to clear a single field. Use this when the user says things like 'set my status to lunch until 1pm' or 'I'm on vacation'.Changes data
set_vacation_settingsUpdate vacation auto-reply settings.Destructive
set_visibilitySet broad access for documents/sheets/slides/canvas/Drive/forms/wiki/calendars, not individual grants or Everyone entries. `restricted` keeps the owner and explicit collaborators and removes broad tiers; `workspace` admits current and future workspace humans and agents at workspaceRole. Result url is the product URL; never share /api/public snapshots. Unsupported fields rejected.Destructive
shared_with_me_hideHide one row from the caller's own Shared-with-me list. Revokes nothing — the grant is untouched and the resource stays reachable by its id or link; only the list entry goes. 404 when the caller holds no live grant or the key lacks that resource's read scope. Idempotent.Destructive
shared_with_me_listEverything shared with the calling account through a direct grant, a team grant, or a bound external grant, across docs / sheets / slides, Drive, Wiki, Forms and Calendar — and across every workspace and identity the account owns. Excludes what the account owns, and excludes workspace-tier access, which is standing authority rather than a share. An API key sees only resource families within its read scopes. Newest share first. `scope=workspace` narrows discovery to resources in the authenticated current workspace without changing access.Read-only
shared_with_me_undo_leaveUndo a "Remove me": restore the exact grant the caller removed, from the `undo_token` the leave call returned. The token is bound to the caller, single-use, and lasts ten minutes. An outside grant is re-checked against the workspace's current outside-sharing policy. 400 `undo_token_invalid` / `undo_token_expired` / `undo_token_used`; 403 `outside_sharing_off` / `outside_sharing_domain_not_allowed`; 404 when the resource is gone or the key lacks its read scope.Changes data
sheet_get_dataGet the spreadsheet as the structured JSON canvas. Returns the `Sheet` envelope: top-level metadata plus the structured sheet body nested under `data` (see `SheetData`). Read the tab list as `response.data.sheets`; columns and rows are under `response.data.sheets[0]`, not at the response root.Read-only
sheet_update_cellsUpdate specific cells in a spreadsheet. Provide an array of cell updates, each specifying the row index (0-based), column ID, and new value. Optional expected_content_sha256 checks the server-issued revision of the entire workbook; preconditions check stored cells and row_count_preconditions check exact tab row counts. All supplied checks run under the mutation lock. A mismatch, or a tab or column the sheet no longer has (TAB_NOT_FOUND, COLUMN_NOT_FOUND), returns 409 without changing values or formatting. If the user is currently viewing a sheet, use the sheet ID from the page context.Changes data
sign_add_fieldAdd a signature field to a signing document.Changes data
sign_add_signerAdd a signer or CC recipient. An agent user can be a CC recipient but never a signer; adding one as a signer is refused.Changes data
sign_get_certificateDownload the Certificate of Completion for a completed document.Read-only
sign_get_referencesList signing documents that use this document as a source.Read-only
sign_prepare_sendValidate signers and render the PDF preview (draft → preview_pending).Changes data
sign_remove_fieldRemove a field from a signing document.Destructive
sign_remove_signerRemove a signer or CC recipient from a draft signing document.Destructive
sign_reorder_signersAtomically set the sequential signing order: the full ordered list of the document's signer-role ids. Draft only.Changes data
sign_update_fieldReassign, reposition, resize, or change requiredness for a field on a draft signing document. The field id is stable — updates never re-create the field.Changes data
sign_verify_documentVerify the integrity and signature of a completed document.Read-only
slide_apply_templateApply a slide template — built-in or workspace — to the deck or to a single slide.Changes data
slide_layouts_listList the slide-level layouts the editor knows about.Read-only
slide_save_as_templateSave an existing deck as a reusable workspace template. Deep-copies the deck with fresh element IDs into a new workspace-visible template document; the source deck is left untouched. Returns the new template's ID.Changes data
slide_stars_listList IDs of slide decks the current user has starred.Read-only
slide_templates_listList the built-in slide deck templates.Read-only
slide_use_templateStart a new deck from a template — built-in or workspace. Deep-copies the template deck with fresh element IDs into a new deck, substitutes `{{key}}` placeholders to bracketed prompts (e.g. `{{client_name}}` → `[Client Name]`), and returns the new deck's ID.Changes data
snooze_emailSnooze an email until a datetime.Changes data
snooze_reminderRe-snooze an existing saved message by updating its remind_at time. Resets reminded to false so the scheduler picks it up again. Accepts ISO 8601 datetime string; must be in the future.Changes data
sort_sheetSort a tab's rows by one column, optionally within an exact filter range. Re-anchors formulas, comment anchors, and cell notes so nothing orphans.Changes data
start_task_timerStart a time-tracking timer on a task for the current user. If another timer is already running for this user, it is stopped automatically (only one active timer per user).Changes data
stop_task_timerStop the current user's active timer on this task and return the stopped entry. Adds its duration to time_spent_minutes. Returns 404 if this user has no active timer on the task.Changes data
submit_feedbackDescribe what happened; only description required. No category or goal outcome; Ambiguous triages. Optional title, priority, context, screenshotDataUrl and attachments. Unauthenticated REST accepted; valid credentials identify reporter. Rate-limited per authenticated user or anonymous IP. Stored as a task in Ambiguous Feedback project; 200 returns task-id receipt. Storage failure 500: retry, no false receipt. Unconfigured intake 503 with {error:"Feedback reporting not available"} (raw response outside contract enum).Destructive
task_asset_createAdd an image to task description. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.Changes data
task_collaborators_addShare a task with one workspace member: grants `editor` on this task and its subtasks (never on its project) and subscribes them. A projectless task is shared by its creator or assignee; a project task by an editor on that project.Changes data
task_collaborators_listList the collaborators on a task — the people holding `editor` on it (and its subtasks) without a role on its project.Read-only
task_collaborators_removeRevoke a task collaborator's grant. The add-time subscription is left in place — it grants no access on its own.Destructive
tasks_activityList audit-log activity entries for a task (status changes, assignments, comments, label edits, etc.). Paginated via `limit`/`offset`.Read-only
tasks_batchBatch-fetch up to 50 tasks by ID. Powers LinkedTaskItem hydration in Docs/Wiki.Read-only
tasks_by_keyResolve a workspace-scoped task key (e.g. `TASK-123`) to its task ID. Used by deep links and integrations.Read-only
tasks_deleteSoft-delete a task. Only the creator can delete.Destructive
tasks_exportExport authorized tasks matching the selected filters as CSV (default) or JSON. CSV includes human-readable columns and a task_json column containing the complete public task representation. Owned description images are embedded; an unavailable or malformed owned image refuses the export with its task reference.Read-only
tasks_favorites_addPin a saved task view or project in your Tasks sidebar. For document, Drive, channel or team favorites, use set_resource_starred.Changes data
tasks_favorites_listList your Tasks-sidebar pins: saved views and projects, not starred documents, Drive items, channels or teams.Read-only
tasks_favorites_removeUnpin a saved task view or project from your Tasks sidebar, matching resource_type and resource_id. For other resource favorites, use set_resource_starred.Destructive
tasks_favorites_reorderReorder your Tasks-sidebar view/project pins using ordered_ids (favorite-row IDs, top-to-bottom), not resource IDs.Changes data
tasks_inbox_countCount of triage-bucket tasks (untriaged + projects in 'triage' status). Powers the sidebar inbox badge.Read-only
tasks_labels_assignAssign a label to a task. Returns the task's full label list.Changes data
tasks_labels_createCreate a workspace task label. Returns 409 if a label with the same name already exists in the group.Changes data
tasks_labels_deleteDelete a task label. Existing assignments are removed.Destructive
tasks_labels_listList task labels visible in the workspace, grouped by `group_name`. Without `project_id`, returns workspace-level labels only. With `project_id`, returns workspace-level labels plus labels scoped to that project.Read-only
tasks_labels_removeRemove a label assignment from a task. Returns the task's remaining label list.Destructive
tasks_labels_updateUpdate a task label.Changes data
tasks_pr_linksList the pull requests linked to a task that you can see: a link shows only when you can read both the task and the repository.Read-only
tasks_relations_batchBatch-fetch every relation type for up to 100 tasks. Powers relation overlays and sweeps.Read-only
tasks_relations_createCreate a relation between two tasks. `blocking`/`blocked_by` auto-creates the inverse edge. With `type=duplicate, mark_as_duplicate=true` the source task is cancelled with a system comment.Changes data
tasks_relations_deleteDelete a task relation edge. Auto-deletes the inverse edge for blocking/blocked_by pairs.Destructive
tasks_relations_listList edges in the task-relations graph for a task (related, blocking, blocked_by, duplicate).Read-only
tasks_remove_subscriberRemove another user's subscription from a task. Requires task access.Destructive
tasks_sla_dashboardAggregate SLA metrics for the workspace (compliance rates, avg times, counts per status). Optionally scope to a project.Read-only
tasks_sla_thresholdsGet the workspace's SLA thresholds (response + resolution times per priority). Auth-only.Read-only
tasks_subscribedList task IDs the caller is subscribed to (manual + auto-subscribed via creator/assignee/comment).Read-only
tasks_subscription_statusCheck whether the current user is subscribed to a task (and the reason if so).Read-only
tasks_subscriptions_listList all users subscribed to a task (with the reason each is subscribed).Read-only
tasks_subtasksList immediate subtasks of a task (`parent_task_id = :id`).Read-only
tasks_templates_deleteDelete a task template. Workspace admins or project admins only.Destructive
tasks_templates_getGet a single task template by ID.Read-only
tasks_templates_updateUpdate a task template. Workspace admins or project admins only.Changes data
tasks_views_createCreate a saved task view (filter + layout). Setting `is_shared: true` exposes it to the workspace.Changes data
tasks_views_deleteDelete a saved task view.Destructive
tasks_views_layout_getGet the caller's layout preferences for a view, or fall back to the view's defaults. `source` indicates which.Read-only
tasks_views_layout_updateUpsert the caller's layout preferences for a view (per-project scope optional).Changes data
tasks_views_listList task views accessible to the caller (own + shared + system defaults).Read-only
tasks_views_updateUpdate a saved task view (rename, change filters or layout defaults, toggle sharing).Changes data
teams_cancel_join_requestCancel your own pending join request for this team.Destructive
teams_get_subscriptionGet the caller's email-delivery preference for the team. Returns `{team_id, user_id, email_delivery}`.Read-only
teams_joinJoin a team. Open teams grant instant membership; request teams create a pending join request; invite teams reject.Changes data
teams_leaveLeave a team. Cannot leave if you're the last admin.Changes data
teams_members_listPaginated member list. Private teams visible only to members or admins.Read-only
teams_members_removeRemove a member. Admin only. Cannot remove the last admin.Destructive
teams_members_update_roleChange a member's role. Admin only. Cannot demote the last admin.Changes data
teams_requests_approveApprove a join request — adds the user as a member.Changes data
teams_requests_denyDeny a join request.Changes data
teams_requests_listList pending join requests. Admin only.Read-only
teams_searchableSearch teams visible to the caller for the share dialog. Returns the union of public teams and private teams where the caller is a member. Supports case-insensitive name filtering via `q` and a configurable `limit`.Read-only
teams_update_subscriptionUpdate the caller's email-delivery preference for the team. Body: `{email_delivery: 'each' | 'daily_digest' | 'weekly_digest' | 'none'}`. `none` is refused on the workspace-wide all-members list, which has no opt-out.Changes data
trash_mail_threadTrash all messages in a thread atomically. Moves every message in the thread to the trash folder.Destructive
unblock_senderUnblock by id or pattern.Changes data
undo_mail_rule_applicationStop application and restore uncontested prior fields exactly once; expired Undo is refused visibly.Destructive
undo_mail_rule_changesetRestore uncontested rule configuration once within the server Undo window. Preserve later edits and labels now used elsewhere; report conflicts. Messages are never changed.Destructive
undo_send_emailUndo an in-flight send within the undo-send window.Changes data
unenroll_contact_from_sequencePermanently remove a contact from a CRM sequence (terminal — sets status to 'unenrolled'). The contact will not receive any further sequence steps. Returns 409 if already in a terminal status. Provide the enrollment ID (not the contact ID — find it via list_sequence_enrollments).Destructive
unfurl_linkFetch OpenGraph / link-preview metadata for a URL (title, description, image, site name, favicon). Useful for generating rich previews of shared links, or inspecting what a URL would look like when shared in chat. Only http(s) URLs are allowed, and internal/private addresses are blocked.Read-only
ungroup_slide_elementsDissolve a group element on a slide back into independent top-level elements. Children positions are converted from group-relative to absolute coordinates. The group element is removed and its former children become top-level elements on the slide.Changes data
unprotect_rangeRemove a protected range from a spreadsheet by its ID. Returns 200 on success, 404 if the range does not exist.Destructive
unpublish_calendarRevoke the public .ics feed for a calendar, making it private again.Destructive
unpublish_formUnpublish a form so it stops accepting public responses. Semantic shortcut for PATCH /api/forms/{id} with is_published=false.Changes data
unsave_messageRemove a saved (bookmarked) message from the user's saved list. The message itself is untouched; only the personal bookmark is deleted.Destructive
untrash_emailRestore a trashed email to inboxChanges data
untrash_mail_threadRestore all trashed messages in a thread to inbox. Only affects messages currently in trash.Changes data
update_accessChange an existing named user/team grant on a document, spreadsheet, presentation, canvas, Drive item, form, wiki page, or calendar. id names the resource; exactly one user_id or team_id names the recipient. For the workspace tier use set_visibility and workspaceRole, not the Everyone entry. role and expires_at are set exactly, including shorter expiry.Changes data
update_canvasUpdate canvas-level metadata (title, preview cover). Use to rename a canvas or set its preview; never touches elements — use the element ops for board content. Coordinates: board units, top-left origin, +x right / +y down. Example: update_canvas({ id: "<boardId>", title: "Renamed board" }).Changes data
update_canvas_timerControl a board's shared brainstorm countdown. Use to time-box a round: start (with duration_ms), pause (banks remaining time), resume (from banked time), or reset (clear). The server stamps `ends_at` from its own clock, so every participant renders the same countdown regardless of local clocks; the timer touches no elements. Coordinates: board units, top-left origin, +x right / +y down (unaffected by the timer). Example: update_canvas_timer({ id: "<boardId>", action: "start", duration_ms: 300000 }) starts a 5-minute countdown.Changes data
update_channel_member_roleChange a channel member's role to 'admin' or 'member'. Requires channel admin privileges. Use this when the user asks to promote or demote a member in a channel.Changes data
update_chartPatch a chart's config — type, title, data range, overlay position, or series styling. Only the fields you send are updated; the rest of the chart config is preserved.Changes data
update_conditional_formatUpdate a conditional formatting rule by ID. Partial update: ranges or one canonical rule payload; replacing the kind clears the previous kind.Changes data
update_contactUpdate an existing CRM contact's fields. Provide only the fields you want to change. For interrupted sync recovery, read the contact and send expected_updated_at with only remaining changes. A 409 carrying contact_id means another contact already has that email; any other 409 means the contact changed: read again and reconcile; never replay an earlier snapshot over newer values. If the user is currently viewing a contact, use the contact ID from the page context.Changes data
update_contact_groupUpdate an existing contact group's name, color, or sort order. Group name must remain unique within the workspace.Changes data
update_crm_lifecycle_stageRename, reorder, archive or restore a People lifecycle stage without changing its stable key or contacts. Workspace admins only.Changes data
update_crm_property_definitionUpdate a custom-property definition's label or select options.Changes data
update_crm_viewUpdate a saved CRM view (rename, change filters, toggle default/shared).Changes data
update_dealUpdate an existing CRM deal's fields. Provide only the fields you want to change. Use this to move a deal to a new stage, update the amount, mark as won/lost, etc. If the user is currently viewing a deal, use the deal ID from the page context.Changes data
update_deal_line_itemUpdate a deal line item (quantity, price, discount, name/description). Amount auto-recomputed. If sync_deal_amount defaults true, the deal's total is also refreshed.Changes data
update_deal_templateUpdate a deal template. Providing `line_items` replaces the entire line-item list.Changes data
update_deck_settingsUpdate deck-level settings: theme, aspect ratio, default background. Changing aspect ratio rescales every slide's elements proportionally; changing default background updates slides currently using the old default.Changes data
update_documentEdit an existing document inline. Read the document first (get_document), modify the content, then pass the full updated text — content replaces the entire body. Do NOT create a new document to edit; version history preserves prior states. Accepts Markdown or ProseMirror JSON (HTML tolerated but lossy — drops listed in `import_warnings`). Provide only the fields you want to change.Changes data
update_document_page_styleSet page-level formatting for a document: margins (PT), page size (letter/A4/legal or {width, height} in PT), orientation (portrait/landscape). 72 PT = 1 inch. These settings control export output (.docx, .pdf). Pass an empty object to reset to defaults.Changes data
update_draft_emailUpdate an existing draft email. Only works on drafts (not sent messages). Use this to refine recipients, subject, or body of a draft across multiple iterations before sending. A native Drive document attached without stored bytes returns 422 native_document_not_copyable; attach it as a link.Changes data
update_eventUpdate an existing calendar event. Provide only the fields you want to change. Use this to reschedule, change attendees, update the description, or cancel an event. If the user is currently viewing an event, use the event ID from the page context.Destructive
update_formUpdate an existing form's title, description, fields, settings, or publish status. Use this when the user asks to edit a form, add/remove fields, publish/unpublish, or change form settings. If the user is currently viewing a form, use the resource ID from page context.Destructive
update_form_variantUpdate an A/B test variant's name, traffic weight, or active status. Use when the user asks to rename a variant, adjust the traffic split, or pause/resume an experiment.Changes data
update_mail_labelUpdate a mail label's name, color or sidebar order.Changes data
update_mail_templateUpdate a saved mail template's subject or body.Changes data
update_named_rangeUpdate a named range or named expression with either an A1 range or an exact literal Excel expression; optionally rename it with newName. Names are matched case-insensitively. External-workbook expressions are preserved verbatim and remain unresolved.Changes data
update_pipelineUpdate a pipeline's name or stages. Providing `stages` replaces the entire stage list — include every stage you want to keep. Reordering is done by the order in the array.Changes data
update_pivot_tablePatch a pivot table's config, including native presentation and preferred cache identity. Only the fields you send are updated; the rest of the pivot config is preserved. Send `nativeCacheId: null` to clear its authored preference. Pass a `tab` field to move the pivot to a different tab.Changes data
update_productUpdate a CRM product's name, price or other fields.Changes data
update_projectUpdate a project's name, description, icon, or color. Provide only the fields you want to change.Changes data
update_quoteUpdate a CRM quote. Providing `line_items` replaces the entire line-item list. Totals are auto-recomputed.Changes data
update_resource_commentUpdate a comment by its ID. content edits the text and only its author may; expected_content checks the original text and rejects a stale edit with 409 comment_edit_conflict. resolved resolves or reopens the comment's thread, which the thread's author or anyone with edit access may do. anchor moves a root comment on a canvas board to a board point or an element, by the same rule; a reply refuses it with 400 comment_anchor_on_reply and any other container with 400 comment_anchor_invalid.Changes data
update_scheduled_messageEdit the content or scheduled send time of a pending scheduled message before it's sent. Fails if the message has already been sent or cancelled. Use this when the user wants to fix a typo in a scheduled message or reschedule it.Changes data
update_scheduler_linkUpdate a scheduler link (rename, change availability, toggle active, etc.).Destructive
update_scoring_ruleUpdate a lead scoring rule (name, field, operator, value, points, is_active).Changes data
update_settingsUpdate workspace settings (name, logo, timezone, etc.). Requires admin role. Pass a flat key-value object.Changes data
update_shared_driveUpdate a shared drive (manager-only).Changes data
update_shared_drive_memberUpdate a member role (manager-only).Changes data
update_sheet_imageUpdate editable floating images with cell anchors and CSS pixel geometry. Image src must reference an image asset owned by this sheet.Changes data
update_sheet_mergesReplace the complete merged-cell range collection for a sheet tab using zero-based inclusive startRow, startCol, endRow and endCol coordinates. Read the current sheet and retain unrelated entries when changing one merge. An empty merges array clears all merges on that tab.Changes data
update_sheet_picture_groupUpdate editable picture groups with cell anchors and CSS pixel geometry. Every leaf references an image asset owned by this sheet; native group transforms use EMU coordinates.Changes data
update_sheet_shapeUpdate editable floating shapes with editable text, cell anchors and CSS pixel geometry.Changes data
update_sheet_validation_settingsSet worksheet validation prompt suppression without replacing cells, rules, or presentation. Send disablePrompts=null to restore the absent default setting.Changes data
update_sign_documentUpdate a draft signing document.Changes data
update_slicerPatch a slicer's config — source range, target column, selected values, overlay position, or title. Only the fields you send are updated; the rest of the slicer config is preserved.Changes data
update_slideUpdate an existing slide in a presentation. Specify the slide by its 0-based index. You can update the slide properties (background, notes) and/or replace its elements. If the user is currently viewing a presentation, use the presentation ID from the page context.Changes data
update_slide_masterUpdate a master slide's name, background, or elements. Slides using the master resolve the updated elements by reference.Changes data
update_sparklineEdit only the supplied sparkline fields while preserving unrelated workbook edits.Changes data
update_taskUpdate a task. Status changes to 'done' auto-spawn the next recurrence (when set), trigger CRM activity logging, and emit task.completed events.Changes data
update_teamUpdate a team's settings (name, slug, description, email, parent, visibility, join policy, posting policy, icon, color). Only team admins or workspace admins can update. If changing parent, validates no cycle in hierarchy. Use this when the user asks to rename a team, move a team under a different parent, or change team settings.Changes data
update_userUpdate a member's display name, username, avatar, storage quota, or workload capacity. Requires admin or owner. Change roles with assign_role/remove_role; suspend or restore access with admin_user_suspend/admin_user_unsuspend.Changes data
update_wiki_pageUpdate an existing wiki page's content, title, icon, or parent. Use this when the user asks to edit a wiki page, update documentation, or move a page to a different parent. If the user is currently viewing a wiki page, use the resource ID from page context.Changes data
update_wiki_synced_blockUpdate a synced block's content. All pages embedding this block will reflect the new content. Use this when the user asks to edit shared content or update a reusable snippet.Changes data
update_workspaceUpdate workspace name or slug. Requires admin role.Changes data
use_mail_templateRecord template use.Changes data
use_sign_templateCreate a new draft document from a template, populating fields with placeholder signer roles.Changes data
users_listList users in the active workspace. Powers @mention pickers, assignee dropdowns, etc. Filterable by q (matches display_name + username substrings or an owned workspace email address, case-insensitive). Limit defaults to 50, hard cap 100. Member-accessible — use this to resolve a name to a user_id when assigning tasks or @mentioning people; the admin list_users tool is admin-gated and 403s for members/coworkers.Read-only
verify_domainTrigger DNS verification for a workspace domain. Requires admin role.Changes data
verify_domain_ownershipVerify custom domain ownership via DNS TXT record. On success, auto-registers with SES to retrieve DKIM/SPF records. Requires admin role.Changes data
webhooks_deleteDelete one webhook subscription by id.Destructive
webhooks_deliveries_listList recent delivery attempts (status, response, retries). Paginated via `?limit=` (default 25) and `?offset=` (default 0).Read-only
webhooks_event_typesList event types an agent can subscribe to. Includes the `*` wildcard.Read-only
webhooks_getGet one webhook subscription's config by id.Read-only
webhooks_listList webhook registrations owned by the caller.Read-only
wiki_database_createCreate an inline database on a wiki page. Requires editor role on the host page.Changes data
wiki_database_getGet an inline database with its full row set.Read-only
wiki_database_row_createAppend a row to an inline database. Requires editor role on the host page. Set a person property to a user id from the users list; other text is stored and shown as written.Changes data
wiki_database_row_deleteDelete a database row.Destructive
wiki_database_row_updateUpdate properties or sort order on a database row. Properties merge: named properties change, others stay, and null clears one. Set a person property to a user id from the users list; other text is stored and shown as written.Changes data
wiki_database_updateUpdate an inline database's name, schema, or views. Requires editor role on the host page.Changes data
wiki_native_backupExport a separately labeled, digest-bound native Wiki backup containing the workspace Wiki graph and page-owned image metadata and bytes. This is not DOCX.Read-only
wiki_native_restoreRestore a native Wiki backup into its empty source workspace. Preserves spaces, hierarchy, page content, databases, backlinks, synced blocks, permissions, versions, comments, and v2 page-owned images. Historical v1 backups contain only the graph.Changes data
wiki_page_asset_createAdd an image to wiki body/cover. Returns the parent-owned image URL `/api/assets/{id}/content`. Input: content_base64 bytes, source_file_id (copies a viewable Drive file), or source_url (copies public HTTPS through SSRF guard); no source link retained. Native sources without stored bytes return 422 native_document_not_copyable; attach it as a link. Byte-sniffed images only, 415 for other types or malformed SVG. SVG sanitized on upload and every read, inline image/svg+xml with restrictive CSP; malformed stored SVG returns 404. Drive SVG stays attachment. Owner quota exceeded 413; same image deduplicated per parent. Absent from Drive, readable exactly with parent.Changes data
wiki_page_backlinks_listList wiki pages that contain `[[link]]` references to this page. Use this to see what pages cite a given page, or to find inbound knowledge links.Read-only
wiki_page_children_listList the immediate child pages of a wiki page. Use this to traverse the page tree one level at a time, or to count children before a destructive delete.Read-only
wiki_page_database_createCreate an inline database on a specific wiki page.Changes data
wiki_page_duplicateDuplicate a wiki page (and optionally its descendants) into a target space + parent. Returns the new top-level page.Changes data
wiki_page_exportExport a wiki page to docx, pdf, html, or md. Streams the file with a Content-Disposition attachment header.Read-only
wiki_page_restoreRestore a trashed wiki page and its children.Changes data
wiki_page_tasks_adoptMove the caller's project-less tasks linked from this wiki page into `project_id`; set the page's tasks project if unset. Other linked tasks are listed in `skipped` and unchanged.Changes data
wiki_space_deleteDelete a wiki space and all of its pages.Destructive
wiki_space_getGet a wiki space by slug, with its full page tree. Supports cursor pagination on `pages`.Read-only
wiki_space_member_addAdd a user as a direct member of a wiki space with a given role.Changes data
wiki_space_member_removeRemove a direct member from a wiki space.Destructive
wiki_space_members_listList distinct members of a space — the owner plus everyone with a page-level permission inside it.Read-only
wiki_space_updateUpdate a wiki space. Only the space owner may change settings.Destructive
wiki_trash_listList trashed (soft-deleted) wiki pages in the workspace.Read-only
write_sheet_tableCreate or edit one table. Bounds describe DATA only; totals follow data. Current headers win; cell exceptions remain.Changes data
write_table_styleCreate or edit a named custom table style from differential elements. False and absent settings differ. expected_updated_at refuses stale replacements with 409; omission deliberately replaces.Changes data

Change history

  1. submit_feedback: input schema changed
  2. set_pinned_header_rows: input schema changed (+model_features)
  3. set_document_footnotes: input schema changed (+model_features)
  4. set_document_footnotes: description changed (+"When stored model requirements apply, send model_features covering them; missing or incomplete required capabilities are refused with 409.")
  5. replace_named_range_content: input schema changed (+model_features)
  6. insert_section_break: input schema changed (+model_features)
  7. insert_page_number: input schema changed (+model_features)
  8. insert_page_break: input schema changed (+model_features)
  9. chat_channel_notification_preference: input schema changed (+user_id)
  10. chat_channel_notification_preference: description changed (+"Per-member;" +"Pass user_id to set an agent's level as an admin, owner or the agent's manager; nobody sets another human's level." -"Per-user;")
  11. wiki_page_database_create: input schema changed
  12. wiki_database_update: input schema changed
  13. wiki_database_create: input schema changed
  14. update_wiki_synced_block: input schema changed
  15. update_task: input schema changed
  16. update_slide_master: input schema changed
  17. update_slide: input schema changed
  18. update_sheet_merges: input schema changed
  19. update_shared_drive_member: input schema changed
  20. update_settings: input schema changed
  21. update_scheduler_link: input schema changed
  22. update_pivot_table: input schema changed
  23. update_mail_label: input schema changed
  24. update_form: input schema changed
  25. update_event: input schema changed
  26. update_draft_email: input schema changed (-attachments)
  27. update_draft_email: description changed (+"A native" +"document attached" +"returns")
  28. update_document_page_style: input schema changed
  29. update_document: input schema changed
  30. update_deck_settings: input schema changed
  31. update_deal_template: input schema changed
  32. update_crm_view: input schema changed
  33. update_channel_member_role: input schema changed
  34. tasks_views_update: input schema changed
  35. tasks_views_create: input schema changed
  36. tasks_templates_update: input schema changed
  37. sheet_update_cells: input schema changed
  38. sheet_update_cells: description changed (+"mismatch, or a tab or column the sheet no longer has (TAB_NOT_FOUND, COLUMN_NOT_FOUND)," -"mismatch")
  39. shared_with_me_hide: input schema changed
  40. set_swipe_actions: input schema changed
  41. set_sheet_validation: input schema changed
  42. set_document_named_styles: input schema changed
  43. set_document_headers_footers: input schema changed
  44. send_email: input schema changed (-attachments)
  45. send_email: description changed (+"A native" +"document attached" +"returns")
  46. send_draft_email: description changed (+"A native" +"document attached" +"returns")
  47. rsvp_event: input schema changed
  48. rsvp_email_invite: input schema changed
  49. replace_sheet_tab: input schema changed (+rowIds)
  50. realtime_exchange_resource_capability: input schema changed
Source listings
SourceListingFirst seenLast seenVersions
claude.com listing pageb5707cc9-04ba-42ab-81bf-e8a43c9e98c813 Nov 202616 Nov 20261
MCPTop directory snapshotanthropic:b5707cc9-04ba-42ab-81bf-e8a43c9e98c813 Nov 202616 Nov 20261