Skip to main content
Glama

share

Destructive

Share management: create/update/delete, archive, password auth, members, autotitle. NOTE: quickshare-create is DEPRECATED (returns error 10756) — use the fileshare tool's create action for durable single-file shares. Call action='describe' for the full action/param reference. Destructive: delete (permanent). Side effects: autotitle AI-generates + applies a title/description (consumes credits, mutates share metadata). ⚠️ intelligence on create COSTS CREDITS (10/page) — default false unless user explicitly requests RAG. Verbosity (detail param): list/available/members default to terse (compact rows). public-details defaults to standard. details defaults to full (drill-down). Pass an explicit detail='terse'|'standard'|'full' to override.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNoShare title (2-80 chars; maps to API 'title').
typeNoFilter by share type.
limitNoInternal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded by list/members.
titleNoShare title (2-80 chars). Alias of name.
actionYesOperation. Use 'describe' for full action reference.
detailNoPer-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists.
expandNoquickshare-create only. Set to 'node' to include the full backend payload as a nested `node` field. Default response is slim: `{id, web_url, expires_at}`.
inviteNoWho can invite others (default: owners).
notifyNoNotification setting (default: never).
offsetNoNumber of items to skip (default 0)
org_idNoFilter shares to this org.
confirmNodelete: must match the share's custom_name or id (validated client-side before the call).
expiresNoExpiration: 'YYYY-MM-DD HH:MM:SS' for create/update; seconds (default 10800, max 604800) for quickshare-create.
node_idNoStorage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days.
passwordNoPassword (only with 'Anyone with the link').
share_idNoShare profile ID or custom name.
room_goalNoREMOVED — Coordination Rooms were deleted from the platform on 2026-08-25 and this parameter no longer does anything. Supplying it is REFUSED rather than ignored, so a stale tool list cannot silently drop your value. Do not use it.
expires_atNoISO 8601 datetime for quickshare expiration.
share_typeNoNew share type.
custom_nameNoCustom share URL name (4-80 chars; Unicode letters, digits, hyphens, underscores). Omit to have one auto-generated.
descriptionNoShare description (10-500 chars).
folder_nameNoName for new folder (default: 'Shared Folder').
accent_colorNoAccent color as JSON string.
display_typeNoDisplay mode (default: grid).
intelligenceNoEnable RAG indexing. ⚠️ COSTS CREDITS (10/page) — default false unless user requests it. Forced false on workspace_folder shares.
storage_modeNoStorage mode (default: independent).
user_contextNoautotitle only: optional user-provided context to guide the AI-generated title/description.
workspace_idNoWorkspace opaque ID. Use this when only workspaces are valid (not shares or other contexts). For polymorphic contexts use profile_id. Parent workspace ID.
create_folderNoCreate a new workspace folder (workspace_folder mode).
display_limitNoHow many items to return. Default 10, max 500. The MCP trims post-fetch; backend page_size stays MCP-internal so the platform cache stays warm. Applies to list.
owner_definedNoCustom metadata as JSON string.
access_optionsNoAccess level. 'Anyone with the link' not allowed for receive/exchange.
folder_node_idNoWorkspace folder node ID (workspace_folder mode).
describe_actionNoWhen action='describe', narrow the output to ONE action's full params/notes (e.g. 'create'). Omit to get the compact action index.
workspace_styleNoUse workspace styling (default: true).
background_imageNoBackground image index (0-128, default 0).
comments_enabledNoEnable comments (default: true).
background_color1NoPrimary background color as JSON string.
background_color2NoSecondary background color as JSON string.
download_securityNoDownload security: off (default), medium (no guest download), high (block all guest downloads).
guest_chat_enabledNoEnable guest chat (default: false).
anonymous_uploads_enabledNoAllow guests to upload anonymously on public Receive/Exchange shares.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / room_goal / description
      Previous value: -"update only, Coordination Rooms only. Correct a room's purpose; share_id IS the room_id. 1-500 chars, no control chars; blank NOT accepted. ANY member of the parent workspace may do this — a room grants share-level Admin to workspace members. The only mutable manifest key; topic_slug is immutable. Non-room share: REFUSED 406. Most OTHER update params are refused on a room — see the action note."New value: +"REMOVED — Coordination Rooms were deleted from the platform on 2026-08-25 and this parameter no longer does anything. Supplying it is REFUSED rather than ignored, so a stale tool list cannot silently drop your value. Do not use it."
  2. Changed1 schema field changed
    • addedInput schema / properties / room_goal
      Added value: +{
      +  "description": "update only, Coordination Rooms only. Correct a room's purpose; share_id IS the room_id. 1-500 chars, no control chars; blank NOT accepted. ANY member of the parent workspace may do this — a room grants share-level Admin to workspace members. The only mutable manifest key; topic_slug is immutable. Non-room share: REFUSED 406. Most OTHER update params are refused on a room — see the action note.",
      +  "maxLength": 1000,
      +  "minLength": 1,
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / custom_name / description
      Previous value: -"Custom share URL name (4-80 chars, alphanumeric)."New value: +"Custom share URL name (4-80 chars; Unicode letters, digits, hyphens, underscores). Omit to have one auto-generated."
  4. Changed3 schema fields changed
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for…"New value: +"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists."
    • changedInput schema / properties / limit / description
      Previous value: -"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded…"New value: +"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded by list/members."
    • changedInput schema / properties / node_id / description
      Previous value: -"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB,…"New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."
  5. Changed21 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "autotitle",
      -  "review-surface-create",
      -  "review-surface-get",
      -  "review-list-active",
      -  "review-cancel",
      -  "review-admin-resolve",
      -  "review-reviewer-add-member",
      -  "review-reviewer-add-external",
      -  "review-reviewer-remove",
      -  "review-decision"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "autotitle"
      +]
    • removedInput schema / properties / asset_id
      Removed value: -{
      -  "description": "Share-review asset id (one reviewed file). review-decision.",
      -  "type": "string"
      -}
    • removedInput schema / properties / comment_text
      Removed value: -{
      -  "description": "review-decision: the reason. REQUIRED (non-blank) for decision='reject'/'request_changes'; optional for 'approve'. A blank reason on reject/request_changes is…",
      -  "maxLength": 65535,
      -  "type": "string"
      -}
    • changedInput schema / properties / confirm / description
      Previous value: -"delete: must match the share's custom_name or id (validated client-side before the call). review-admin-resolve: must be 'true' (the force-resolve confirmation…"New value: +"delete: must match the share's custom_name or id (validated client-side before the call)."
    • removedInput schema / properties / deadline_at
      Removed value: -{
      -  "description": "review-surface-create: optional review deadline ('YYYY-MM-DD HH:MM:SS' UTC).",
      -  "type": "string"
      -}
    • removedInput schema / properties / decision
      Removed value: -{
      -  "description": "review-decision: approve | reject | request_changes (sent to the platform as `action`).",
      -  "enum": [
      -    "approve",
      -    "reject",
      -    "request_changes"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / email
      Removed value: -{
      -  "description": "review-reviewer-add-external: external reviewer email.",
      -  "minLength": 3,
      -  "type": "string"
      -}
    • removedInput schema / properties / idempotency_key
      Removed value: -{
      -  "description": "review-surface-create: replay-safe key (1-128). REQUIRED; same key returns the existing surface.",
      -  "maxLength": 128,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / invite_notes
      Removed value: -{
      -  "description": "review-reviewer-add-external: optional note included in the magic-link invite email.",
      -  "maxLength": 4000,
      -  "type": "string"
      -}
    • removedInput schema / properties / member_user_id
      Removed value: -{
      -  "description": "Share member's User ID to add as a reviewer. review-reviewer-add-member (must be a share member).",
      -  "type": "string"
      -}
    • removedInput schema / properties / message
      Removed value: -{
      -  "description": "review-surface-create: optional message to reviewers (max 4000).",
      -  "maxLength": 4000,
      -  "type": "string"
      -}
    • removedInput schema / properties / node_ids
      Removed value: -{
      -  "description": "review-surface-create (target_mode=fileset): JSON array of node ids to review. Native or string.",
      -  "type": "string"
      -}
    • removedInput schema / properties / outcome
      Removed value: -{
      -  "description": "review-admin-resolve: force-resolve outcome approved|rejected.",
      -  "enum": [
      -    "approved",
      -    "rejected"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / policy_mode
      Removed value: -{
      -  "description": "review-surface-create: approval policy. quorum needs policy_quorum_n.",
      -  "enum": [
      -    "single",
      -    "unanimous",
      -    "quorum",
      -    "all_assets_all_approved",
      -    "overall_signoff"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / policy_quorum_n
      Removed value: -{
      -  "description": "review-surface-create: required approvals when policy_mode='quorum'.",
      -  "maximum": 9007199254740991,
      -  "minimum": 1,
      -  "type": "integer"
      -}
    • removedInput schema / properties / reviewer_id
      Removed value: -{
      -  "description": "Share-review reviewer roster id. review-reviewer-remove.",
      -  "type": "string"
      -}
    • removedInput schema / properties / reviewer_name
      Removed value: -{
      -  "description": "review-reviewer-add-external: external reviewer's display name (1-255 chars; sent to the platform body field `name`). REQUIRED for review-reviewer-add-external.",
      -  "maxLength": 255,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / reviewers
      Removed value: -{
      -  "description": "review-surface-create: REQUIRED non-empty JSON array of reviewer entries. Each entry is {\"kind\":\"member\",\"user_id\":\"<member user id>\"} OR…",
      -  "type": "string"
      -}
    • removedInput schema / properties / surface_id
      Removed value: -{
      -  "description": "Share-review surface OpaqueId. review-surface-get/-cancel/-admin-resolve/-reviewer-*/-decision.",
      -  "type": "string"
      -}
    • removedInput schema / properties / target_mode
      Removed value: -{
      -  "description": "review-surface-create: fileset (specific node_ids) or whole_share.",
      -  "enum": [
      -    "fileset",
      -    "whole_share"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / version_id_pinned
      Removed value: -{
      -  "description": "review-decision: pinned asset version (CAS).",
      -  "type": "string"
      -}
  6. Changed3 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "autotitle",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear",
      -  "review-surface-create",
      -  "review-surface-get",
      -  "review-list-active",
      -  "review-cancel",
      -  "review-admin-resolve",
      -  "review-reviewer-add-member",
      -  "review-reviewer-add-external",
      -  "review-reviewer-remove",
      -  "review-decision"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "autotitle",
      +  "review-surface-create",
      +  "review-surface-get",
      +  "review-list-active",
      +  "review-cancel",
      +  "review-admin-resolve",
      +  "review-reviewer-add-member",
      +  "review-reviewer-add-external",
      +  "review-reviewer-remove",
      +  "review-decision"
      +]
    • removedInput schema / properties / content
      Removed value: -{
      -  "description": "Markdown body for AI instructions slot (max 65536 bytes UTF-8). Full replace.",
      -  "type": "string"
      -}
    • removedInput schema / properties / scope
      Removed value: -{
      -  "description": "AI instructions scope: 'profile' (share-wide; owner/admin) or 'me' (per-user; registered members only). Independent slots, do NOT merge.",
      -  "enum": [
      -    "profile",
      -    "me"
      -  ],
      -  "type": "string"
      -}
  7. Changed26 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "autotitle",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear",
      +  "review-surface-create",
      +  "review-surface-get",
      +  "review-list-active",
      +  "review-cancel",
      +  "review-admin-resolve",
      +  "review-reviewer-add-member",
      +  "review-reviewer-add-external",
      +  "review-reviewer-remove",
      +  "review-decision"
      +]
    • addedInput schema / properties / asset_id
      Added value: +{
      +  "description": "Share-review asset id (one reviewed file). review-decision.",
      +  "type": "string"
      +}
    • addedInput schema / properties / comment_text
      Added value: +{
      +  "description": "review-decision: the reason. REQUIRED (non-blank) for decision='reject'/'request_changes'; optional for 'approve'. A blank reason on reject/request_changes is…",
      +  "maxLength": 65535,
      +  "type": "string"
      +}
    • changedInput schema / properties / confirm / description
      Previous value: -"Must match share ID or custom_name."New value: +"delete: must match the share's custom_name or id (validated client-side before the call). review-admin-resolve: must be 'true' (the force-resolve confirmation…"
    • addedInput schema / properties / deadline_at
      Added value: +{
      +  "description": "review-surface-create: optional review deadline ('YYYY-MM-DD HH:MM:SS' UTC).",
      +  "type": "string"
      +}
    • addedInput schema / properties / decision
      Added value: +{
      +  "description": "review-decision: approve | reject | request_changes (sent to the platform as `action`).",
      +  "enum": [
      +    "approve",
      +    "reject",
      +    "request_changes"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / describe_action
      Added value: +{
      +  "description": "When action='describe', narrow the output to ONE action's full params/notes (e.g. 'create'). Omit to get the compact action index.",
      +  "type": "string"
      +}
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists."New value: +"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for…"
    • addedInput schema / properties / email
      Added value: +{
      +  "description": "review-reviewer-add-external: external reviewer email.",
      +  "minLength": 3,
      +  "type": "string"
      +}
    • addedInput schema / properties / idempotency_key
      Added value: +{
      +  "description": "review-surface-create: replay-safe key (1-128). REQUIRED; same key returns the existing surface.",
      +  "maxLength": 128,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / invite_notes
      Added value: +{
      +  "description": "review-reviewer-add-external: optional note included in the magic-link invite email.",
      +  "maxLength": 4000,
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of items to return (1-500, default 100)"New value: +"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded…"
    • addedInput schema / properties / member_user_id
      Added value: +{
      +  "description": "Share member's User ID to add as a reviewer. review-reviewer-add-member (must be a share member).",
      +  "type": "string"
      +}
    • addedInput schema / properties / message
      Added value: +{
      +  "description": "review-surface-create: optional message to reviewers (max 4000).",
      +  "maxLength": 4000,
      +  "type": "string"
      +}
    • changedInput schema / properties / node_id / description
      Previous value: -"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB,…"
    • addedInput schema / properties / node_ids
      Added value: +{
      +  "description": "review-surface-create (target_mode=fileset): JSON array of node ids to review. Native or string.",
      +  "type": "string"
      +}
    • addedInput schema / properties / outcome
      Added value: +{
      +  "description": "review-admin-resolve: force-resolve outcome approved|rejected.",
      +  "enum": [
      +    "approved",
      +    "rejected"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / policy_mode
      Added value: +{
      +  "description": "review-surface-create: approval policy. quorum needs policy_quorum_n.",
      +  "enum": [
      +    "single",
      +    "unanimous",
      +    "quorum",
      +    "all_assets_all_approved",
      +    "overall_signoff"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / policy_quorum_n
      Added value: +{
      +  "description": "review-surface-create: required approvals when policy_mode='quorum'.",
      +  "maximum": 9007199254740991,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / reviewer_id
      Added value: +{
      +  "description": "Share-review reviewer roster id. review-reviewer-remove.",
      +  "type": "string"
      +}
    • addedInput schema / properties / reviewer_name
      Added value: +{
      +  "description": "review-reviewer-add-external: external reviewer's display name (1-255 chars; sent to the platform body field `name`). REQUIRED for review-reviewer-add-external.",
      +  "maxLength": 255,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / reviewers
      Added value: +{
      +  "description": "review-surface-create: REQUIRED non-empty JSON array of reviewer entries. Each entry is {\"kind\":\"member\",\"user_id\":\"<member user id>\"} OR…",
      +  "type": "string"
      +}
    • addedInput schema / properties / surface_id
      Added value: +{
      +  "description": "Share-review surface OpaqueId. review-surface-get/-cancel/-admin-resolve/-reviewer-*/-decision.",
      +  "type": "string"
      +}
    • addedInput schema / properties / target_mode
      Added value: +{
      +  "description": "review-surface-create: fileset (specific node_ids) or whole_share.",
      +  "enum": [
      +    "fileset",
      +    "whole_share"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / user_context
      Added value: +{
      +  "description": "autotitle only: optional user-provided context to guide the AI-generated title/description.",
      +  "type": "string"
      +}
    • addedInput schema / properties / version_id_pinned
      Added value: +{
      +  "description": "review-decision: pinned asset version (CAS).",
      +  "type": "string"
      +}
  8. Changed16 schema fields changed
    • removedInput schema / properties / background_image / anyOf
      Removed value: -[
      -  {
      -    "maximum": 128,
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / background_image / maximum
      Added value: +128
    • addedInput schema / properties / background_image / minimum
      Added value: +0
    • addedInput schema / properties / background_image / type
      Added value: +"integer"
    • removedInput schema / properties / display_limit / anyOf
      Removed value: -[
      -  {
      -    "maximum": 500,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / display_limit / maximum
      Added value: +500
    • addedInput schema / properties / display_limit / minimum
      Added value: +1
    • addedInput schema / properties / display_limit / type
      Added value: +"integer"
    • removedInput schema / properties / limit / anyOf
      Removed value: -[
      -  {
      -    "maximum": 500,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / limit / maximum
      Added value: +500
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / limit / type
      Added value: +"integer"
    • removedInput schema / properties / offset / anyOf
      Removed value: -[
      -  {
      -    "maximum": 9007199254740991,
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / offset / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / offset / minimum
      Added value: +0
    • addedInput schema / properties / offset / type
      Added value: +"integer"
  9. Changed4 schema fields changed
    • removedInput schema / properties / custom_name / pattern
      Removed value: -"^[\\p{L}\\p{N}]+$"
    • removedInput schema / properties / description / pattern
      Removed value: -"^[^\\p{C}]*$"
    • removedInput schema / properties / name / pattern
      Removed value: -"^[^\\p{C}]*$"
    • removedInput schema / properties / title / pattern
      Removed value: -"^[^\\p{C}]*$"
  10. Changed50 schema fields changed
    • changedInput schema / properties / accent_color / description
      Previous value: -"Accent color as JSON string (used by: create)"New value: +"Accent color as JSON string."
    • changedInput schema / properties / access_options / description
      Previous value: -"Access level. 'Anyone with the link' not allowed for receive/exchange shares. (used by: create, update)"New value: +"Access level. 'Anyone with the link' not allowed for receive/exchange."
    • changedInput schema / properties / action / description
      Previous value: -"Operation to perform"New value: +"Operation. Use 'describe' for full action reference."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear"
      +]
    • changedInput schema / properties / anonymous_uploads_enabled / description
      Previous value: -"Enable anonymous file uploads on public Receive/Exchange shares. When true with 'Anyone' access, guests can upload without registration. Not applicable to Send shares or Portals (Send-only shares with independent storage). (used by: create, update)"New value: +"Allow guests to upload anonymously on public Receive/Exchange shares."
    • changedInput schema / properties / background_color1 / description
      Previous value: -"Primary background color as JSON string (used by: create)"New value: +"Primary background color as JSON string."
    • changedInput schema / properties / background_color2 / description
      Previous value: -"Secondary background color as JSON string (used by: create)"New value: +"Secondary background color as JSON string."
    • addedInput schema / properties / background_image / anyOf
      Added value: +[
      +  {
      +    "maximum": 128,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / background_image / description
      Previous value: -"Background image index (0-128, default: 0) (used by: create)"New value: +"Background image index (0-128, default 0)."
    • removedInput schema / properties / background_image / type
      Removed value: -"number"
    • changedInput schema / properties / comments_enabled / description
      Previous value: -"Enable comments (default: true) (used by: create, update)"New value: +"Enable comments (default: true)."
    • changedInput schema / properties / confirm / description
      Previous value: -"Confirmation value: must match share ID or custom_name (required for: delete)"New value: +"Must match share ID or custom_name."
    • changedInput schema / properties / content / description
      Previous value: -"Full markdown body that replaces the AI instructions slot (max 65536 bytes UTF-8). instructions-set is full replace — to append, GET → concat client-side → set. (used by: instructions-set)"New value: +"Markdown body for AI instructions slot (max 65536 bytes UTF-8). Full replace."
    • changedInput schema / properties / create_folder / description
      Previous value: -"Create a new workspace folder (workspace_folder mode) (used by: create)"New value: +"Create a new workspace folder (workspace_folder mode)."
    • changedInput schema / properties / custom_name / description
      Previous value: -"Custom share URL name (4-80 chars, alphanumeric + unicode letters) (used by: create)"New value: +"Custom share URL name (4-80 chars, alphanumeric)."
    • changedInput schema / properties / description / description
      Previous value: -"Share description (10-500 chars) (used by: create, update)"New value: +"Share description (10-500 chars)."
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists.",
      +  "enum": [
      +    "terse",
      +    "standard",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / display_limit
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 500,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "pattern": "^-?\\d+$",
      +      "type": "string"
      +    }
      +  ],
      +  "description": "How many items to return. Default 10, max 500. The MCP trims post-fetch; backend page_size stays MCP-internal so the platform cache stays warm. Applies to list."
      +}
    • changedInput schema / properties / display_type / description
      Previous value: -"Display mode (default: 'grid') (used by: create)"New value: +"Display mode (default: grid)."
    • changedInput schema / properties / download_security / description
      Previous value: -"Download security level: 'off' (no restrictions, default), 'medium' (guests can preview but not download), 'high' (all guest downloads blocked). (used by: create, update)"New value: +"Download security: off (default), medium (no guest download), high (block all guest downloads)."
    • addedInput schema / properties / expand
      Added value: +{
      +  "description": "quickshare-create only. Set to 'node' to include the full backend payload as a nested `node` field. Default response is slim: `{id, web_url, expires_at}`.",
      +  "enum": [
      +    "node"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / expires / description
      Previous value: -"Expiration: datetime string YYYY-MM-DD HH:MM:SS for create/update, or seconds from creation for quickshare-create (default 10800, max 604800 = 7 days). Alternatively use expires_at with ISO 8601 datetime for quickshare-create. Not allowed on workspace_folder shares. (used by: create, update, quickshare-create)"New value: +"Expiration: 'YYYY-MM-DD HH:MM:SS' for create/update; seconds (default 10800, max 604800) for quickshare-create."
    • changedInput schema / properties / expires_at / description
      Previous value: -"ISO 8601 datetime for quickshare expiration as alternative to expires in seconds. Example: 2026-03-12T15:00:00Z. (used by: quickshare-create)"New value: +"ISO 8601 datetime for quickshare expiration."
    • changedInput schema / properties / folder_name / description
      Previous value: -"Name for new folder (default: 'Shared Folder') (used by: create)"New value: +"Name for new folder (default: 'Shared Folder')."
    • changedInput schema / properties / folder_node_id / description
      Previous value: -"Workspace folder node ID (workspace_folder mode) (used by: create)"New value: +"Workspace folder node ID (workspace_folder mode)."
    • changedInput schema / properties / guest_chat_enabled / description
      Previous value: -"Enable guest chat (default: false) (used by: create)"New value: +"Enable guest chat (default: false)."
    • changedInput schema / properties / intelligence / description
      Previous value: -"Enable AI-powered RAG indexing and semantic search on the share. ⚠️ COSTS CREDITS: 10 credits per page for every uploaded document — can consume the entire free plan budget quickly. MUST default to false unless the user explicitly requests RAG or AI search. NOT SUPPORTED on workspace_folder shares — always forced to false; use the parent workspace's AI endpoints instead. (default: false) (used by: create)"New value: +"Enable RAG indexing. ⚠️ COSTS CREDITS (10/page) — default false unless user requests it. Forced false on workspace_folder shares."
    • changedInput schema / properties / invite / description
      Previous value: -"Who can invite others (default: 'owners') (used by: create)"New value: +"Who can invite others (default: owners)."
    • addedInput schema / properties / limit / anyOf
      Added value: +[
      +  {
      +    "maximum": 500,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / limit / maximum
      Removed value: -500
    • removedInput schema / properties / limit / minimum
      Removed value: -1
    • removedInput schema / properties / limit / type
      Removed value: -"integer"
    • changedInput schema / properties / name / description
      Previous value: -"Share title (2-80 chars; maps to API 'title') (used by: create, update, check-name)"New value: +"Share title (2-80 chars; maps to API 'title')."
    • changedInput schema / properties / node_id / description
      Previous value: -"File node opaque ID (required for: quickshare-create). Quick shares: single file only, max 1 GB, default expiration 3 hours, max 7 days (1 week), auto-deleted on expiration."New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."
    • changedInput schema / properties / notify / description
      Previous value: -"Notification setting (default: 'never') (used by: create)"New value: +"Notification setting (default: never)."
    • addedInput schema / properties / offset / anyOf
      Added value: +[
      +  {
      +    "maximum": 9007199254740991,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / offset / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / offset / minimum
      Removed value: -0
    • removedInput schema / properties / offset / type
      Removed value: -"integer"
    • changedInput schema / properties / org_id / description
      Previous value: -"Filter to shares in this org (list action)"New value: +"Filter shares to this org."
    • changedInput schema / properties / owner_defined / description
      Previous value: -"Custom metadata as JSON string (used by: create)"New value: +"Custom metadata as JSON string."
    • changedInput schema / properties / password / description
      Previous value: -"Password for share access (only with 'Anyone with the link') (used by: create, password-auth)"New value: +"Password (only with 'Anyone with the link')."
    • changedInput schema / properties / scope / description
      Previous value: -"AI instructions scope. \"profile\" (default) targets the share-wide slot at /share/{share_id}/instructions/ — owner/admin only (403 code 166463 for non-admins). \"me\" targets the per-user slot at /share/{share_id}/instructions/me/ — registered members only (403 code 185733 for anonymous/link guests). The two scopes are independent slots and do NOT merge server-side; concat client-side if you want a combined view. (used by: instructions-get, instructions-set, instructions-clear)"New value: +"AI instructions scope: 'profile' (share-wide; owner/admin) or 'me' (per-user; registered members only). Independent slots, do NOT merge."
    • changedInput schema / properties / share_id / description
      Previous value: -"Share profile ID or custom name"New value: +"Share profile ID or custom name."
    • changedInput schema / properties / share_type / description
      Previous value: -"New share type (used by: create, update)"New value: +"New share type."
    • changedInput schema / properties / storage_mode / description
      Previous value: -"Storage mode (default: 'independent') (used by: create)"New value: +"Storage mode (default: independent)."
    • changedInput schema / properties / title / description
      Previous value: -"Share title (2-80 chars). 'name' param also sets title; use either one. (used by: create)"New value: +"Share title (2-80 chars). Alias of name."
    • changedInput schema / properties / type / description
      Previous value: -"Filter by share type (list action)"New value: +"Filter by share type."
    • changedInput schema / properties / workspace_id / description
      Previous value: -"Parent workspace ID (required for: create, quickshare-create)"New value: +"Workspace opaque ID. Use this when only workspaces are valid (not shares or other contexts). For polymorphic contexts use profile_id. Parent workspace ID."
    • changedInput schema / properties / workspace_style / description
      Previous value: -"Use workspace styling (default: true) (used by: create)"New value: +"Use workspace styling (default: true)."
  11. Changed3 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow"
      -]New value: +[
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear"
      +]
    • addedInput schema / properties / content
      Added value: +{
      +  "description": "Full markdown body that replaces the AI instructions slot (max 65536 bytes UTF-8). instructions-set is full replace — to append, GET → concat client-side → set. (used by: instructions-set)",
      +  "type": "string"
      +}
    • addedInput schema / properties / scope
      Added value: +{
      +  "description": "AI instructions scope. \"profile\" (default) targets the share-wide slot at /share/{share_id}/instructions/ — owner/admin only (403 code 166463 for non-admins). \"me\" targets the per-user slot at /share/{share_id}/instructions/me/ — registered members only (403 code 185733 for anonymous/link guests). The two scopes are independent slots and do NOT merge server-side; concat client-side if you want a combined view. (used by: instructions-get, instructions-set, instructions-clear)",
      +  "enum": [
      +    "profile",
      +    "me"
      +  ],
      +  "type": "string"
      +}
  12. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations: it flags delete as permanent, discloses that autotitle consumes credits and mutates share metadata, warns that intelligence costs credits (10/page) and defaults to false, and explains per-action verbosity defaults. No contradiction with the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Dense but well-organized: purpose first, then deprecation warning, self-reference to describe, destructive semantics, side effects, cost warning, and verbosity defaults. Every sentence carries operational value, and the warnings are visually flagged.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 42-parameter, multi-action tool with no output schema, the description covers deprecation, cost, destructive behavior, side effects, and verbosity defaults, and provides an action='describe' escape hatch for further detail. It is not fully self-contained regarding return values, but that is a reasonable deferral for such a complex tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema itself already documents key behaviors like credit costs, removed parameters, and limit/display_limit semantics. The description reinforces cost and verbosity defaults but adds little parameter-level meaning beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'Share management: create/update/delete, archive, password auth, members, autotitle' — a specific, verb-rich inventory of operations rather than a tautology. It also names the sibling tool fileshare as the replacement for the deprecated quickshare-create, helping distinguish this tool from related siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly routes agents away from deprecated quickshare-create toward fileshare's create for durable single-file shares, and directs agents to call action='describe' for the full action/param reference. It doesn't enumerate every possible alternative sibling, but the critical routing decision is covered clearly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources