Dutify

它列出的 191 个工具

“只读”和“会改数据”是服务方自己标的。带下划线的参数是必填的。

1. find_my_workspace只读

   Unified Dutify find_my_workspace: fresh credential/workspace discovery. Does not require a selected workspace or reserve quota.

   account workspace

2. fr_comment_bug

   Add a comment to a bug report. Pass isInternal=true for internal-only. API-key scope: `feedback:comments:write`.

   shortId content isInternal account workspace

3. fr_comment_request

   Add a comment to a feature request. Pass isInternal=true to make the comment visible only to users with `View Internal Data` permission. API-key scope: `feedback:comments:write`.

   shortId content isInternal account workspace

4. fr_create_bug

   Create a new bug report on a board. Severity and productArea are resolved by name (lenient match). Environment is a free-form map (browser, OS, url, etc.). API-key scope: `feedback:bugs:write`.

   boardSlug title severity productArea stepsToReproduce expectedResult actualResult environment isSecurity account workspace

5. fr_create_request

   Create a new feature request on a board. Category is resolved by name (lenient match). No turnstile token required — API-key authentication is sufficient. Returns the new request with assigned shortId. API-key scope: `feedback:requests:write`.

   boardSlug title description category account workspace

6. fr_delete_bug会改数据

   Permanently delete a bug report. Requires `Manage Queue` permission. Irreversible. API-key scope: `feedback:bugs:write`.

   shortId account workspace

7. fr_delete_request会改数据

   Permanently delete a feature request. Requires `Manage Queue` permission. Returns 204 on success. This operation is irreversible — confirm with the user before calling unless the intent is unambiguous. API-key scope: `feedback:requests:write`.

   shortId account workspace

8. fr_get_bug只读

   Get a bug report by short ID (e.g. "BG-99"). Returns full detail: title, reproduction steps, expected/actual result, severity, status, product area, assignee, affectedCount, environment, comments count. Internal notes and linkedIssueUrl populated only for `View Internal Data` permission. API-key scope: `feedback:bugs:read`.

   shortId account workspace

9. fr_get_request只读

   Get a feature request by short ID (e.g. "FR-42"). Returns full detail: title, description, status, category, milestone, voteCount, commentCount, reactions. Internal notes and linkedTaskIds are populated only when the caller has `View Internal Data` permission. API-key scope: `feedback:requests:read`.

   shortId account workspace

10. fr_list_bugs只读

    List bug reports on a feedback board (by board slug). Filter by severity and/or status name (lenient match). API-key scope: `feedback:bugs:read`.

    boardSlug severity status account workspace

11. fr_list_requests只读

    List feature requests on a feedback board (by board slug). Filter by status / category / milestone name (lenient — trimmed + case-insensitive). Pass `q` to search request titles instead. Paginated via page/size. API-key scope: `feedback:requests:read`.

    boardSlug status category milestone q page size account workspace

12. fr_moderate_bug会改数据

    Approve, reject, or mark a bug as spam. Action is case-insensitive. Requires `Manage Queue` permission. API-key scope: `feedback:moderation:write`.

    shortId action account workspace

13. fr_moderate_request会改数据

    Approve, reject, or mark a feature request as spam. Action is case-insensitive. Requires `Manage Queue` permission. API-key scope: `feedback:moderation:write`.

    shortId action account workspace

14. fr_set_bug_assignee会改数据

    Assign or unassign a bug. Provide `assigneeEmail` (resolved case-insensitive against workspace members) OR `assigneeId` (UUID). Exactly one; both = 400. Passing neither unassigns. API-key scope: `feedback:bugs:write`.

    shortId assigneeEmail assigneeId account workspace

15. fr_set_bug_status会改数据

    Change a bug status by name (lenient match against the board's bug-status set). API-key scope: `feedback:bugs:write`.

    shortId status account workspace

16. fr_set_bug_visibility会改数据

    Toggle a bug's public visibility. Security bugs stay private regardless. API-key scope: `feedback:bugs:write`.

    shortId isPublic account workspace

17. fr_set_request_status会改数据

    Change a feature request's status by name. The name is resolved leniently against the request's board's status set (trim + case-insensitive). Returns the updated request detail. API-key scope: `feedback:requests:write`.

    shortId status account workspace

18. fr_toggle_bug_affected会改数据

    Toggle the caller's "I'm affected" marker on a bug. Returns the updated bug detail with new affectedCount. API-key scope: `feedback:bugs:write`.

    shortId account workspace

19. fr_vote_request会改数据

    Toggle a vote or emoji reaction on a feature request. Passing emoji=null or omitting the field registers a plain upvote. Calling the tool again with the same emoji removes the vote (idempotent toggle). API-key scope: `feedback:votes:write`.

    shortId emoji account workspace

20. get_api_catalog只读

    Discover deployed API tags or a tag schema for one product. Prefers the versioned service-qualified catalog; falls back only when unsupported. Discovery never grants access.

    service tag account workspace

21. get_endpoint_examples只读

    Fetch the request/response example payloads (full JSON values) for a Dutify API resource tag. Use this when you're about to write rich content via a tool that accepts a TipTap `content` parameter (e.g. wiki_create_page) and need a concrete reference of what the doc shape looks like — banners, collapsibles, mermaid diagrams, code blocks with language, mentions, inline labels, tables, task lists, etc. Pass the resource tag (e.g. "Wiki Pages (Lite)", "Milestone Articles"). Optionally narrow with `operationId` (e.g. "createPage") and `name` (e.g. "full" or "full-tiptap") — both names appear in the per-tag detail response so an agent can pick exactly the example it needs without paying tokens for the rest. Returns the catalog JSON; the example payloads are under `operations[*].requestBodyExamples[name].value`. Tag list (lightweight) is at GET /v1/api-catalog. Per-tag detail (schemas, no example bodies) is at GET /v1/api-catalog/{tag}. This tool calls the third tier — GET /v1/api-catalog/{t

    tag operationId name account workspace

22. hub_clear_call_custom_prompt会改数据

    Remove the caller's own per-call prompt. Their next hub_regenerate_summary uses their instruction set without a per-call prompt. Requires recordings:write scope.

    id account workspace

23. hub_clear_event_custom_prompt会改数据

    Remove one occurrence's own prompt. The series prompt, if any, keeps applying on its own — nothing 'falls back', the series prompt was already in use. Requires recordings:write scope.

    eventId account workspace

24. hub_clear_series_custom_prompt会改数据

    Remove a series' custom prompt. Each occurrence keeps only its own prompt, if it has one. Never clear a series prompt to 'avoid a conflict' with an occurrence prompt: there is no conflict, both apply, and clearing it drops instructions every other occurrence relies on. Requires recordings:write scope.

    seriesMasterId account workspace

25. hub_count_calls只读

    Return the total number of calls visible to the actor user. Use to plan pagination. Requires recordings:read scope.

    account workspace

26. hub_count_search_calls只读

    Count of calls matching a search query. Pair with `hub_search_calls` for paginated UIs. Requires recordings:read scope.

    query account workspace

27. hub_delete_call会改数据

    Delete a call by ID. Hard-deletes both the UserCall metadata and the underlying recording media. NOT REVERSIBLE — use with care. Requires recordings:write scope.

    id account workspace

28. hub_get_audio_url只读

    Generate a short-lived signed URL to download the recording's audio (typically MP3 or WAV). The URL is valid for `expiryMinutes` minutes (default 30, max enforced by Hub). The agent should NOT cache the URL — request a fresh one each time the audio is needed. Requires recordings:read scope.

    recordingId expiryMinutes account workspace

29. hub_get_call只读

    Fetch a single call by ID. Returns the full UserCallDTO. Field map (the DTO is deeply nested): - top-level `id` (integer) — what /usercall/{id} expects, what list/search return - top-level `clickupList`/`jiraProjectId`/`airtableBaseId`/`airtableTableId` — populated when this call has been pushed to that vendor - top-level `summaryApplied`/`actionItemsApplied`/etc. (bool) — has the summary/etc. been pushed? - `call.id` (integer) — INTERNAL Zoom/Meet/Teams call id, NOT for /usercall/{id} paths - `call.callUuid` (string) — what `hub_send_call_to_jira/clickup/airtable` want as `callUUID` - `call.attendees` (string, often "") — NOT a structured array - `call.recordings[i].id` (integer) — recording id for /recording/{id}/audio-url etc. - `call.recordings[i].summary`/`keyPoints`/`actionItems`/`enhancedNotes` — markdown STRINGS, not arrays; the CALLER's own version (generated from their workspace prompt, per-call prompt, notes and note template), never another participa

    id account workspace

30. hub_get_custom_prompt只读

    Get the workspace's custom prompt — house-style instructions that, together with each participant's own per-call prompt, notes and note template, form the instruction set their version of the summary, key points, action items and enhanced notes is generated from (task generation too). Returns { customPrompt: string | null }. Requires workspace-settings:read scope.

    account workspace

31. hub_get_default_workspace只读

    Get the user's "default workspace" — where new calendar events without an explicit assignment get routed. Returns { workspaceId: uuid | null }. Requires user-settings:read scope.

    account workspace

32. hub_get_media_url只读

    Like `hub_get_audio_url` but returns the full media (video + audio) when the recording has a video track. Falls back to audio-only when there isn't one. Same expiry semantics. Requires recordings:read scope.

    recordingId expiryMinutes account workspace

33. hub_get_preferred_integration只读

    Get the workspace's preferred integration target — which task system new actions are routed to by default (Jira, ClickUp, Airtable, PM, etc.). Requires workspace-settings:read scope.

    account workspace

34. hub_get_preview_url只读

    Get a signed URL for the recording's preview thumbnail (a still image or short looping clip). Useful for embedding a card. Same expiry semantics. Requires recordings:read scope.

    recordingId expiryMinutes account workspace

35. hub_get_recording_progress只读

    Get the processing progress of a recording. Returns an integer 0-100 — useful for polling after a `hub_reprocess_recording` call. Requires recordings:read scope.

    recordingId account workspace

36. hub_get_workspace只读

    Get details for the selected workspace (or the workspace bound to a workspace key) (the one this API key was provisioned for). Hub does not currently expose a single-workspace GET, so this returns the matching entry from the user's workspaces list. Requires workspaces:read scope.

    account workspace

37. hub_lens_chat会改数据

    Run a Lens chat query against the workspace's knowledge (recordings, calls, transcripts, integrated SaaS data). Returns the synthesized answer as a string. Pass `lastMessage` (the new user turn) and optionally `history` (prior turns). For multi-turn conversations the agent SHOULD pass an accumulating history so Lens can resolve references like "the last call we discussed". Calls can take 15-30s on synthesis-heavy queries; the MCP timeout is generous to allow this. Requires lens:chat scope.

    lastMessage history account workspace

38. hub_list_calendar_events只读

    List the actor user's calendar events in a date range. Use this to find the eventId or seriesMasterId a prompt should attach to. Each event includes subject, start/end, whether a recording bot is subscribed, and any eventCustomPrompt / seriesCustomPrompt already set. Events belong to the user across all workspace assignments; workspace assignment is processing context, not ownership. Requires calendar:read scope.

    startDate endDate account workspace

39. hub_list_calls只读

    Page through all calls the actor user can see (their own + any explicitly shared). Returns a list of UserCallDTO. Pagination is page+size; sort order is most-recent first. Requires recordings:read scope.

    page size account workspace

40. hub_list_integrations只读

    List all integrations connected to the selected workspace (or the workspace bound to a workspace key). Returns one entry per connected toolkit (Slack, Jira, ClickUp, Airtable, Notion, Gmail, GCal, GitHub, etc.) with system name, connection status, last sync time, and any vendor metadata. Useful for choosing which `setPreferredIntegration` value is valid, or for reporting connection health to the user. Requires integrations:read scope.

    account workspace

41. hub_list_members只读

    List all members of the selected workspace (or the workspace bound to a workspace key). Each entry includes user UUID, email, name, role, and join timestamp. Useful for "tag this person", "summarize who said what in the last call", etc. Requires members:read scope.

    account workspace

42. hub_regenerate_summary会改数据

    Re-run the analysis for the CALLER's own version of the summary, key points, action items and (when they have notes) enhanced notes, against the existing transcript and using their CURRENT instruction set (workspace prompt, per-call prompt, notes and note template). Other participants' versions are never touched. Cheaper than `hub_reprocess_recording`. Returns the new summary text. Requires recordings:write scope.

    recordingId saveToDb account workspace

43. hub_reprocess_recording会改数据

    Re-run the FULL pipeline on a recording: transcription + summary + key points + action items. Slower and more expensive than `hub_regenerate_summary`. Use when a fresh transcription would meaningfully improve the result (different language detection, speaker diarization fix, etc.). Returns the updated recording DTO. Requires recordings:write scope.

    recordingId regenerate account workspace

44. hub_search_calls只读

    Free-text search across call name, description, attendees, and recording transcript content. Returns paginated UserCallDTO results. Requires recordings:read scope.

    query page size account workspace

45. hub_send_call_to_airtable会改数据

    Push a call's extracted tasks into Airtable rows under one base + one or more tables. Requires recordings:write scope AND an Airtable integration on the workspace. Same return-shape caveat as `hub_send_call_to_jira` — boolean response = "request accepted", not "actually pushed".

    callUUID baseId tableIds account workspace

46. hub_send_call_to_clickup会改数据

    Push a call's extracted tasks into a ClickUp list. Requires recordings:write scope AND a ClickUp integration on the workspace. Same return-shape caveat as `hub_send_call_to_jira` — boolean response = "request accepted", not "actually pushed".

    callUUID selectedListId account workspace

47. hub_send_call_to_jira会改数据

    Push a call's extracted tasks into one or more Jira projects under the same cloud. Hub fans the action items out across the listed projects. Requires recordings:write scope AND a Jira integration on the workspace (see `hub_list_integrations`). IMPORTANT: returns boolean — `true` means Hub ACCEPTED the request, NOT that it actually landed in Jira. The vendor push happens async and silently fails on bad cloudId/project/expired tokens. To confirm landing, call `hub_get_call` again and check that `jiraProjectId` is populated.

    callUUID cloudId projectIds account workspace

48. hub_set_call_custom_prompt会改数据

    Set the custom prompt on an already-recorded call, by its integer call id. This is the right tool for meetings that never had a calendar event (ad-hoc desktop or bot recordings), and for re-analysing a call differently. It is the CALLER's own prompt: it shapes only their version of the summary, key points, action items and enhanced notes. Stored only — follow it with hub_regenerate_summary to rebuild that version. Requires recordings:write scope.

    id customPrompt account workspace

49. hub_set_custom_prompt会改数据

    Update the workspace's custom prompt. Pass null or empty string to clear it. Takes effect on the next recording processed, or on hub_regenerate_summary for an existing one; existing recordings are not re-analysed automatically. Requires workspace-settings:write scope.

    customPrompt account workspace

50. hub_set_default_workspace会改数据

    Set the user's "default workspace" to the workspace this API key is bound to (future calendar events without an explicit workspace will route here). To clear the default entirely, pass { clear: true }. The MCP fills the workspace UUID from the selected workspace (or the workspace bound to a workspace key) automatically — agents do not need to (and cannot) target a different workspace from this key. Requires user-settings:write scope.

    clear account workspace

51. hub_set_event_custom_prompt会改数据

    Set the custom prompt for ONE calendar occurrence. For a series occurrence it is applied TOGETHER with the series prompt (and the workspace prompt), not instead of them; for a one-off meeting it is the meeting's only per-call prompt. Takes effect the next time that meeting is processed. Requires recordings:write scope.

    eventId customPrompt account workspace

52. hub_set_preferred_integration会改数据

    Set the workspace's preferred integration target. The value should be the integration system name returned by `hub_list_integrations` (e.g. "JIRA", "CLICKUP", "AIRTABLE", "PM"). Requires workspace-settings:write scope.

    preferredIntegration account workspace

53. hub_set_series_custom_prompt会改数据

    Set the custom prompt for an entire recurring series. Applies to every occurrence, IN ADDITION to any occurrence-specific prompt set with hub_set_event_custom_prompt (both are applied when both are set). Requires recordings:write scope.

    seriesMasterId customPrompt workspaceId account workspace

54. list_accounts只读

    List the accounts configured for this MCP session. Returns one entry per account with `name` (the label the caller passes as the `account` tool argument) and `workspace` (the workspace identifier or name declared for that account). API keys are not returned. In single-account mode (X-API-Key with optional X-Dutify-Workspace), returns a single entry with name="default". In multi-account mode (X-Dutify-Accounts header), returns every configured account. Call this first when you do not know which account names are available.

    account workspace

55. list_boards只读

    List feature-request boards the caller can view in the current workspace. Each entry includes the board slug and the short-ID prefixes (featureRequestKey, bugReportKey) needed to address requests/bugs in follow-up tool calls.

    account workspace

56. list_spaces只读

    List wiki spaces the caller can view in the current workspace, each with a page count. Use the `key` field as the space identifier in follow-up wiki tool calls.

    account workspace

57. list_workspaces只读

    Unified Dutify list_workspaces: fresh credential/workspace discovery. Does not require a selected workspace or reserve quota.

    account workspace

58. pm_add_comment_reaction会改数据

    Add an emoji reaction to a task comment. `reactionType` is the emoji code (e.g. "thumbs_up", "heart", "smile"). Each user may add at most one reaction of each reactionType per comment. Requires COMMENT-level access on the task. API-key scope: `tasks:write`.

    taskIdentifier commentIdentifier reactionType account workspace

59. pm_add_tasks_to_sprint会改数据

    Associate tasks with a sprint. All tasks must belong to the same space as the sprint group. Pass identifiers (tsk_…), not task keys. Returns updated SprintDTO. API-key scope: `sprints:write`.

    sprintIdentifier taskIdentifiers account workspace

60. pm_add_team_member会改数据

    Add a single user to a team. Pass the user UUID (from pm_list_workspace_members). Idempotent — adding a user who is already a member is a no-op. Requires MANAGE_TEAMS. API-key scope: `teams:write`.

    identifier userUuid account workspace

61. pm_bulk_change_task_type会改数据

    Change the task type for many tasks at once (≤5000 per call). `taskIdentifiers` are stable wire identifiers (e.g. tsk_…) — task keys (PROJ-42) are NOT accepted here; use pm_search_tasks first if you only have keys. `taskType` is a name (e.g. "Bug") or null to clear the type. Returns 200 sync for ≤500 tasks; 202 with a {jobId, statusUrl} for larger batches — poll the statusUrl for completion. API-key scope: `tasks:write`.

    taskIdentifiers taskType account workspace

62. pm_cancel_invitation会改数据

    Revoke a pending workspace invitation by its identifier. Caller needs MANAGE_USERS permission. Returns 204. API-key scope: `users:write`.

    invitationIdentifier account workspace

63. pm_change_member_role会改数据

    Change a member's workspace access level. `userUuid` is the target user's UUID (NOT email — call pm_list_workspace_members first to find it). `workspaceAccessLevelId` is a numeric Long id from the workspace `/access-levels` catalogue (e.g. 1, 2, 3) — fetch it via the catalog meta tools or your existing endpoint introspection if you don't already have it. Caller needs MANAGE_USERS permission. Note: this endpoint is HTTP PUT on the collection path (not PATCH on a sub-resource). API-key scope: `workspaces:write`.

    userUuid workspaceAccessLevelId account workspace

64. pm_clone_view

    Clone an existing view into a (possibly different) scope. Requires VIEW on the source and EDIT on the target scope. API-key scope: `views:write`.

    identifier scope scopeIdentifier name account workspace

65. pm_complete_sprint会改数据

    Transition a sprint from IN_PROGRESS to DONE. Optionally pass `rolloverSprintIdentifier` to move incomplete tasks into a different sprint (typically the next one in the group). Omit the field to leave incomplete tasks unsorted (no rollover). API-key scope: `sprints:write`.

    sprintIdentifier rolloverSprintIdentifier account workspace

66. pm_configure_task_sharing会改数据

    Enable, disable, or reconfigure public sharing for a task. Pass `shared: true` to generate a public link (or refresh the configuration); the response includes the resulting publicLink. Pass `shared: false` to revoke an existing share. All other fields are optional toggles for which slices of the task are visible to a public viewer. Requires FULL access to the task. API-key scope: `tasks:write`.

    taskIdentifier shared expiresAt shareAssignee shareDescription shareStatus sharePriority shareDueDate shareComments shareAttachments shareCustomFields sharedCustomFieldIdentifiers shareSubtasks shareTags account workspace

67. pm_confirm_import_mappings会改数据

    Confirm column mappings for a previewed CSV import job and start async import processing. Call this AFTER another (non-MCP) client has uploaded the CSV via /csv/preview and produced a job in PREVIEW status. `columnMappings` is a non-empty array of objects with: csvHeader (exact CSV column name), targetField (e.g. 'title', 'status', or a custom field identifier), and targetType ('builtin' or 'custom_field'). API-key scope: `imports:write`.

    jobIdentifier columnMappings account workspace

68. pm_count_unread_notifications只读

    Return the bare unread-notification count (a Long) for the current user in the active workspace. The response body is a single number, not an object. API-key scope: `notifications:read`.

    account workspace

69. pm_create_automation

    Create an automation rule. Exactly ONE scope must be set — `listIdentifier` OR `folderIdentifier` OR `spaceIdentifier`. `triggers` and `actions` are arrays; `conditionNodes` is the flattened condition tree (omit for "always-true"). All `parameters` fields on triggers/actions/conditions are JSON-encoded strings, not nested objects. Before crafting, call pm_list_reference_data to learn the valid action/condition/trigger types. API-key scope: `automations:write`.

    name description active listIdentifier folderIdentifier spaceIdentifier triggers actions conditionNodes account workspace

70. pm_create_custom_field

    Create a custom field at workspace / space / list scope. scope=workspace ignores scopeName; scope=space takes a space name; scope=list takes a list name (first match in the workspace). For dropdown / labels (multi-select) types, pass `options` as an array of {value, color?, emoji?, orderIndex?}. Keep field names plain for column headers; set semantic emoji/color metadata for visual icons, using supported keys from pm_list_reference_data (custom-field-icon-options). Reuse suitable existing fields before creating another; color dropdown/label options consistently. CREATING A FIELD IS NOT ENOUGH TO MAKE IT VISIBLE: a custom field only shows up where it's added to a view's columns. After creating fields for a list, finish by creating/updating a view (pm_create_view / pm_update_view) whose `columns` include these fields, or the list keeps a defaults-only, empty-looking view. API-key scope: `custom_fields:write`.

    scope scopeName name type emoji color options account workspace

71. pm_create_folder

    Create a folder inside a space. Space identified by name. API-key scope: `folders:write`.

    space name idempotencyKey account workspace

72. pm_create_list

    Create a task list inside a space (optionally inside a folder). Space and folder are identified by name. Omit folder to create the list directly under the space. Prefer setting icon and color on create when the list purpose is known. For icon, prefer a semantic emoji name first; use an icon identifier only when no emoji fits. List setup is not finished after this call: unless the user requested a bare list, reuse/add relevant custom fields with emoji/color header metadata, refresh pm_get_workspace_context, then use pm_list_views and pm_update_view to configure the auto-created primary view with explicit ordered columns and useful grouping/sorting. Verify the saved configuration before reporting completion. API-key scope: `lists:write`.

    space folder name icon color idempotencyKey account workspace

73. pm_create_space

    Create a new space in the current workspace. Description / icon / color / isPrivate are optional metadata. Returns LiteSpaceResponse. API-key scope: `spaces:write`.

    name description icon color isPrivate idempotencyKey account workspace

74. pm_create_sprint

    Create a sprint inside a sprint group. New sprints start in NOT_STARTED state. `name` required (max 200 chars). `goal`, `startDate`, `endDate` optional (ISO-8601 instants for dates). API-key scope: `sprints:write`.

    groupIdentifier name goal startDate endDate account workspace

75. pm_create_sprint_group

    Create a sprint group inside a space. `name` is required (max 100 chars). `description` is optional (max 2000 chars). `defaultDurationDays` is the default sprint length used when creating new sprints (1–90 days, optional). API-key scope: `sprints:write`.

    spaceIdentifier name description defaultDurationDays account workspace

76. pm_create_tag

    Create a new tag in a space. Tags are auto-created on first inline use (e.g. `tags: ["urgent"]` when creating a task via the Lite API), so use this only when you need to pre-create a tag with specific colors before applying it. Returns the persisted TagDTO with its identifier. API-key scope: `tags:write`.

    spaceIdentifier name backgroundColor textColor account workspace

77. pm_create_task

    Create a task. In the result, title/webUrl are for presentation; displayKey is the optional visible key. Keep key/identifier for API calls and do not expose a hidden raw key in the summary. References are name-based: status/priority/level/taskType are names; assignees are emails; tags are strings (auto-created if missing); customFields is a {name: value} map. `list` is the task-list identifier (tl_…). For subtasks, set `parent` to a task key or identifier (omit `list` and the parent's list is used). Task type is OPTIONAL: omit `taskType` to inherit the closest non-null default along the three-level chain `list → folder → space`. There's NO workspace-level fallback — if all three are null the task is created untyped (`taskType: null` in the response), which is a valid persistent state. Use `pm_list_task_types` to see what types this workspace has (9 SYSTEM rows seeded at workspace creation, plus any CUSTOM ones). MANDATORY CUSTOM FIELDS: a list can mark custom fields required (isMandato

    list title description parent nextTo status priority level taskType tags assignees customFields startDate dueDate estimatedTime isPrivate recurrenceRule idempotencyKey account workspace

78. pm_create_task_comment

    Add a comment to a task. `mentions` is an array of emails — the server resolves them to user UUIDs and substitutes `@<email>` literals in `text` with mention spans. Pass `replyTo` (a comment identifier) to thread. API-key scope: `tasks:write`.

    ref text mentions replyTo account workspace

79. pm_create_task_relationship

    Create a relationship from one task to another. `type` is the relationship-type name in the workspace (e.g. "Blocking"). `target` is a task key or identifier. The current task (ref) is the owner. API-key scope: `tasks:write`.

    ref type target account workspace

80. pm_create_team

    Create a new team in the current workspace. Returns the persisted TeamDTO including its identifier. Requires the workspace MANAGE_TEAMS permission. API-key scope: `teams:write`.

    name alias description icon color memberUuids account workspace

81. pm_create_view

    Create a view. type is one of list / board / table / dashboard / gantt / calendar / gallery. For a newly created list, prefer configuring its auto-created primary view with pm_update_view; add another view only for a distinct workflow. ALWAYS pass `columns` listing exactly what should be visible, in display order, INCLUDING every custom field you want shown — a view created without `columns` falls back to system defaults, so custom fields you just created will NOT appear and the view looks empty. This is the most common mistake here: do not create a view and forget to select its columns. If unsure which custom-field column identifiers exist for this scope, call pm_get_workspace_context first instead of guessing. Columns and filters are applied atomically with the create — invalid columnIdentifier or filter shape rolls the whole create back with 400, so a 201 always means the view exists and is fully configured. In columns, the list order is display order and omitted columns are hidden.

    scope scopeIdentifier name type isPrivate groupBy sortBy sortDirection filters columns account workspace

82. pm_create_webhook

    Create an outgoing webhook subscription for the current workspace. Every delivery is signed with HMAC-SHA256 of the raw body using the webhook secret, sent as `X-Webhook-Signature-256: sha256=<hex>`. Pass your own `secret`, or omit it and this tool generates one and returns it as `secret` in the result. SAVE THE SECRET IMMEDIATELY: pm_get_webhook / pm_list_webhooks never return it; to rotate it, pass a new `secret` to pm_update_webhook. Event types: Project Management events are dash-cased (e.g. "task-created", "task-status-changed", "comment-added"); wiki (Codexum) events are dotted and start with "wiki." (e.g. "wiki.page.published", "wiki.comment.added"); feature-request (Roadmarq) events start with "feedback." (e.g. "feedback.request.created", "feedback.bug.created"). Call pm_list_webhook_event_types for the full list with each type's product and allowed scopes. An unscoped webhook may mix products. Optionally narrow delivery to one entity with scopeType plus scopeEntityIdentifier:

    url name secret eventTypes scopeType scopeEntityIdentifier account workspace

83. pm_delete_automation会改数据

    Delete an automation rule. Returns 204. Existing audit log rows are preserved. API-key scope: `automations:write`.

    identifier account workspace

84. pm_delete_custom_field会改数据

    Delete a custom field and all its values. Requires FULL access. 204. API-key scope: `custom_fields:write`.

    identifier account workspace

85. pm_delete_folder会改数据

    Soft-delete a folder and its child lists+tasks. Requires FULL access. 204. API-key scope: `folders:write`.

    identifier account workspace

86. pm_delete_list会改数据

    Soft-delete a list and its tasks. Requires FULL access. 204. API-key scope: `lists:write`.

    identifier account workspace

87. pm_delete_saved_filter会改数据

    Delete a saved filter you own. NOTE: `id` is a numeric Long (e.g. 42), NOT a slug. Only the owner may delete. Returns 204. There is NO endpoint to "apply" a saved filter — that is a UI affordance only. API-key scope: `filters:write`.

    listIdentifier id account workspace

88. pm_delete_sprint会改数据

    Soft-delete a sprint. Tasks lose their sprint association but remain in their lists. 204 on success. API-key scope: `sprints:write`.

    sprintIdentifier account workspace

89. pm_delete_tag会改数据

    Delete a tag. The tag is removed from every task that currently carries it; the tasks themselves are not affected. Returns 204. API-key scope: `tags:write`.

    identifier account workspace

90. pm_delete_task会改数据

    Delete a task by ref. Cascade-deletes subtasks. Requires FULL access (not just EDIT). Returns 204 on success. API-key scope: `tasks:write`.

    ref account workspace

91. pm_delete_task_comment会改数据

    Delete a comment. Only the original author may delete. Returns 204. API-key scope: `tasks:write`.

    ref commentIdentifier account workspace

92. pm_delete_task_relationship会改数据

    Delete a relationship by identifier. Returns 204. API-key scope: `tasks:write`.

    ref relationshipIdentifier account workspace

93. pm_delete_team会改数据

    Delete a team. Removes the team and all of its grants — existing access controls that referenced this team are reduced accordingly. Returns 204. Requires the workspace MANAGE_TEAMS permission. API-key scope: `teams:write`.

    identifier account workspace

94. pm_delete_time_entry会改数据

    Delete a time entry from a task. NOTE: `timeEntryId` is a numeric Long (e.g. 42), NOT a slug/identifier. Returns 204 on success. API-key scope: `time:write`.

    taskIdentifier timeEntryId account workspace

95. pm_delete_view会改数据

    Delete a view by identifier. Mandatory views (system-created defaults) return 409 Conflict. Returns 204 on success. API-key scope: `views:write`.

    identifier account workspace

96. pm_delete_webhook会改数据

    Delete a webhook subscription permanently. Stops all future deliveries. Returns 204. The HMAC secret cannot be recovered — recreate the webhook to get a new one. API-key scope: `webhooks:write`.

    webhookIdentifier account workspace

97. pm_describe_status_priority_level_endpoints只读

    Orientation/meta tool: return the canonical REST paths and field shapes for managing the Status, Priority, and Task-Level catalogues at each scope (workspace / space / folder / list). Call this ONCE before reaching for endpoint-example tools — it cuts a 30-tool surface down to a single readable map. The agent can then use the catalog tools (e.g. `get_endpoint_examples`) to fetch real request/response bodies for whichever path it picks.

    account workspace

98. pm_get_automation只读

    Fetch a single automation by identifier. Returns the full AutomationDTO including triggers, condition tree, and actions. API-key scope: `automations:read`.

    identifier account workspace

99. pm_get_automation_audit只读

    Fetch the execution audit log for an automation. Each row records a single firing — timestamp, triggering task, trigger type, overall execution status (SUCCESS/FAILED/IN_PROGRESS/ROLLED_BACK), and per-action audit detail. Use to debug "did my automation run?" — it is the authoritative answer; the UI does not currently show summary stats. API-key scope: `automations:read`.

    identifier account workspace

100. pm_get_current_user只读

     Get the profile of the human behind the API key — identifier, email, fullName, and the userSettings object. Use this when the agent needs to address the user by name, route a notification to the right preference channel, or confirm "whose API key am I holding". API-key scope: `users:read`.

     account workspace

101. pm_get_dashboard只读

     Get aggregated counts and breakdowns (status / priority / assignee distributions, custom-field summaries) for any scope. Useful for "how is project X doing?" questions without paginating through tasks. API-key scope: `dashboards:read`.

     scope scopeIdentifier account workspace

102. pm_get_import_job只读

     Fetch the current status and progress of a CSV import job by identifier. Use this to poll a job that another client started via /csv or /csv/preview. API-key scope: `imports:write`.

     jobIdentifier account workspace

103. pm_get_notification_settings只读

     Read the current user's aggregated notification settings: `{pm, codexum, roadmarq}`. `pm` holds the Project Management settings; `codexum` (wiki) and `roadmarq` (feedback) each hold `appChannel`, `emailChannel` and `browserChannel`, each `{settings: {key: true|false}}`. Use this to find out which notification is on before asking the user to flip one; pm_update_notification_channel changes the codexum and roadmarq ones. API-key scope: `users:read`.

     account workspace

104. pm_get_sprint只读

     Fetch a sprint by identifier. Returns SprintDTO with task statistics. API-key scope: `sprints:read`.

     sprintIdentifier account workspace

105. pm_get_sprint_burndown只读

     Return burndown/burnup chart data for the sprint — daily snapshots of remaining vs completed work. Use this to render burndown charts or audit sprint progress over time. API-key scope: `sprints:read`.

     sprintIdentifier account workspace

106. pm_get_sprint_tasks只读

     List all tasks currently in the sprint. Returns an array of full TaskDTO. API-key scope: `sprints:read`.

     sprintIdentifier account workspace

107. pm_get_subtasks只读

     List the direct subtasks (one level deep) of a parent task by ref. API-key scope: `tasks:read`.

     ref limit cursor account workspace

108. pm_get_tag只读

     Fetch a single tag by identifier. Returns the TagDTO (identifier, name, backgroundColor, textColor). API-key scope: `tags:read`.

     identifier account workspace

109. pm_get_task只读

     Fetch a task by ref. Ref accepts a system identifier (tsk_…) OR a task key (e.g. 'PROJ-42'). Returns LiteTaskResponse with names instead of UUIDs and emails instead of user UUIDs. Internal note: when ref is a task key the workspace query param is required — the MCP injects it automatically. Present title linked to webUrl; show displayKey only when non-empty. Do not display the raw key when displayKey is null or absent. API-key scope: `tasks:read`.

     ref account workspace

110. pm_get_task_sharing只读

     Read a task's current public sharing settings. Returns the full TaskSharingSettingsDTO — `shared` (is the public link active), `publicLink` (the share URL when active), `expiresAt`, and per-field visibility toggles (shareAssignee, shareDescription, shareStatus, sharePriority, shareDueDate, shareComments, shareAttachments, shareCustomFields, shareSubtasks, shareTags) plus the explicit list of custom-field identifiers exposed (sharedCustomFieldIdentifiers). Requires at least VIEW access to the task. API-key scope: `tasks:read`.

     taskIdentifier account workspace

111. pm_get_team只读

     Fetch a team by identifier. Returns the full TeamDTO with members. API-key scope: `teams:read`.

     identifier account workspace

112. pm_get_view只读

     Fetch a view by identifier (vw_…). API-key scope: `views:read`.

     identifier account workspace

113. pm_get_webhook只读

     Fetch a single webhook by identifier. Returns its url / name / eventTypes / scope / active flag; does NOT return the HMAC secret (only available at creation time). API-key scope: `webhooks:read`.

     webhookIdentifier account workspace

114. pm_get_webhook_usage只读

     Report webhook quota for the current workspace: { userManaged, agentManaged, total, max }. `total` is the count of active subscriptions and `max` is the per-workspace cap; `agentManaged` is the subset created via API keys (like this MCP). Check this before calling pm_create_webhook in bulk — creation fails once `total` reaches `max`. API-key scope: `webhooks:read`.

     account workspace

115. pm_get_workspace_context只读

     Single-call workspace orientation: members, spaces (with folders, lists, per-list statuses/priorities/taskTypes/customFields), workspace-level taskTypes, relationshipTypes, tags. The biggest agent-onboarding tool — call it first when starting in a new workspace. Folders nest at any depth: every folder has its own `lists` and its sub-folders in `folders` (same shape), so walk `folders` recursively to find every list. Only what you can see is returned; anything visible inside a folder you can't see is listed under the nearest visible parent. Pass shallow=true to skip per-list statuses/priorities for a faster tree-only response. Each per-list custom field carries an `isMandatory` flag — fields with isMandatory=true MUST be supplied in `customFields` when creating/updating a task in that list, or the write is rejected with 400 VALIDATION_ERROR. API-key scope: `workspaces:read`.

     shallow space includeCustomFields includeTaskTypes includeRelationshipTypes includeTags account workspace

116. pm_get_workspace_user_avatar_url只读

     Return the avatar URL for a specific user in the current workspace. The response is a short-lived signed URL pointing at the user's avatar image — embed it in chat messages, mentions, or attribution UI. Returns null if the user has no avatar set. API-key scope: `users:read`.

     userUuid account workspace

117. pm_leave_workspace会改数据

     Voluntarily leave the current workspace. WARNING: this affects the calling user (the user identity behind the API key) — there is no parameter to pick a different user. The workspace owner cannot leave; they must transfer ownership first. After a successful leave the API key may stop working against this workspace. No body. API-key scope: `workspaces:write`.

     account workspace

118. pm_list_automations_for_folder只读

     List automations scoped to a folder. Automations attached at folder level cascade to every list inside that folder unless overridden at the list level. API-key scope: `automations:read`.

     folderIdentifier account workspace

119. pm_list_automations_for_list只读

     List automations scoped to a specific list. Each row is an AutomationDTO with name, active, triggers, conditionNodes, actions, and the owning scope identifiers. API-key scope: `automations:read`.

     listIdentifier account workspace

120. pm_list_automations_for_space只读

     List automations scoped to a space. Automations attached at space level cascade to every list and folder inside that space. API-key scope: `automations:read`.

     spaceIdentifier account workspace

121. pm_list_comment_reactions只读

     List reactions on a task comment. Page-style pagination (page/size). API-key scope: `tasks:read`.

     taskIdentifier commentIdentifier page size account workspace

122. pm_list_import_jobs只读

     List CSV import jobs for the current workspace, paginated. The actual CSV upload endpoints (/csv and /csv/preview) are multipart/form-data and are not exposed by the MCP — agents that want to start a fresh import must upload via a non-MCP client and then come back here with the returned jobIdentifier. API-key scope: `imports:write`.

     page pageSize account workspace

123. pm_list_invitations只读

     List pending (not yet accepted, not expired) invitations for the current workspace. Caller needs MANAGE_USERS permission. Returns an array of InvitationDTO. API-key scope: `users:read`.

     account workspace

124. pm_list_notifications只读

     List notifications for the current user in the active workspace. NOTE: this endpoint uses PAGE-style pagination (?page=&size=) not cursor-based — unusual for this API. `page` is 0-indexed; `size` is 1–100. Optional `unreadOnly`, `sortColumn`, `sortDirection`. API-key scope: `notifications:read`.

     unreadOnly page size sortColumn sortDirection account workspace

125. pm_list_reference_data只读

     List a Dutify reference-data enum (status types, custom-field types, view types, automation action/condition types, access levels, etc.). Returns the authoritative set of values the backend accepts — call this BEFORE guessing enum strings on a create/update payload to avoid 400s. Categories: - custom-field-types: Custom-field type catalogue: text, number, dropdown, date, money, file, rollup, formula, … Use the `identifier` from each row as the `fieldType` value when creating a custom field via /v1/lists/{id}/custom-fields or pm_create_custom_field. - custom-field-icon-options: Custom-field icon catalogue: supported iconNames, emojiNames, and defaultIconsByFieldType. Use one of these keys as the `emoji` value; keep custom-field names plain. Agent preference: choose a semantically matching emojiNames key when available (severity/urgency=fire, target/goal=direct_hit, launch=rocket, approval/success=white_check_mark, location=pushpin, budget=moneybag); use iconNames for structural/type

     category account workspace

126. pm_list_saved_filters只读

     List the current user's saved filters for a list. Filters are USER-scoped — they are not visible to other workspace members. API-key scope: `filters:read`.

     listIdentifier account workspace

127. pm_list_sprint_groups只读

     List all sprint groups in a space. Sprint groups are containers for sprints — each group has its own state machine (only one IN_PROGRESS sprint per group). Returns an array of SprintGroupDTO. API-key scope: `sprints:read`.

     spaceIdentifier account workspace

128. pm_list_task_comments只读

     List comments on a task by ref. Cursor-paginated. API-key scope: `tasks:read`.

     ref limit cursor account workspace

129. pm_list_task_relationships只读

     List all relationships where the task is owner OR child. Cursor-paginated. API-key scope: `tasks:read`.

     ref limit cursor account workspace

130. pm_list_task_types只读

     Return the workspace task-type catalogue (identifier, name, singularName, pluralName, iconKind, iconValue, color, sortOrder, origin SYSTEM/CUSTOM). Use this to discover what types are available before creating/updating tasks or setting a default with pm_set_default_task_type. API-key scope: `workspaces:read`.

     account workspace

131. pm_list_teams只读

     List teams in the current workspace, paginated. Each team carries identifier, name, alias, description, icon, color, and member list. Use pagination if there are many teams. API-key scope: `teams:read`.

     page size sortColumn sortDirection account workspace

132. pm_list_time_entries只读

     List time entries logged against a task. `taskIdentifier` must be a stable identifier (tsk_…), not a task key. Supports page/size/sortColumn/sortDirection (page-style). API-key scope: `time:read`.

     taskIdentifier page size sortColumn sortDirection account workspace

133. pm_list_views只读

     List views at a given scope. scope is one of workspace/space/folder/list; scopeIdentifier is the UUID of the parent entity (omit for workspace scope — the MCP's configured workspace is used). Cursor-paginated. API-key scope: `views:read`.

     scope scopeIdentifier limit cursor account workspace

134. pm_list_webhook_deliveries只读

     List recent delivery attempts for a webhook (most recent first). Each entry includes the event type, response status, attempt count, and timestamps. Useful for diagnosing why a subscriber is missing events. Pagination uses `cursor` (or `page`) and `size` (max 100, default backend-defined). API-key scope: `webhooks:read`.

     webhookIdentifier cursor size limit account workspace

135. pm_list_webhook_event_types只读

     List every event type a webhook can subscribe to, across Project Management, the wiki (Codexum) and feature requests (Roadmarq). Returns [{type, product ("pm" | "codexum" | "roadmarq"), description, scopes}], where `scopes` are the scopeType values the type can be narrowed by. Use it to pick eventTypes for pm_create_webhook instead of guessing. API-key scope: `webhooks:read`.

     account workspace

136. pm_list_webhooks只读

     List webhook subscriptions in the current workspace. By default only the webhooks the caller created are listed; pass `all: true` to list every webhook in the workspace (needs the MANAGE_WEBHOOKS permission, else 403). The HMAC `secret` is NOT included. Pass `url` to return only the webhooks whose URL matches it exactly. Each entry reports scopeType, scopeEntityIdentifier, scopeEntityName and includeSecurityBugs; for a FEEDBACK_BOARD scope, scopeEntityIdentifier is the board UUID, also when it was set by slug. API-key scope: `webhooks:read`.

     url all account workspace

137. pm_list_workspace_members只读

     List members of the current workspace. Workspace is taken from the MCP config — no need to pass it. RESPONSE IS A PAGINATED ENVELOPE, NOT AN ARRAY: {users: WorkspaceUserDTO[], totalCount, page, size, totalPages} — read members from `users` (treating the response itself as a list fails). FOOTGUN: `size` DEFAULTS TO 20 when omitted, so a single call silently returns only the first 20 members and no error — don't assume it's the full roster. To enumerate everyone, page (page is 0-based) until you have collected `totalCount`. `size` is capped at 100 and a value >100 is a 400, not clamped. Use `search` (case-insensitive substring on first/last name or email, applied before paging) to find a specific member instead of paging blindly. Side effect: updates the caller's last-active timestamp. API-key scope: `workspaces:read`.

     page size search sortColumn sortDirection account workspace

138. pm_log_time

     Log a time entry against a task. `timeSpent` is in minutes (0 to 10080 — 7 days max). `startedAt` is an ISO-8601 instant marking when the tracked work started. `notes` is optional (max 10000 chars). The user is set server-side from the JWT — do NOT pass userUuid. API-key scope: `time:write`.

     taskIdentifier timeSpent startedAt notes account workspace

139. pm_mark_all_notifications_read会改数据

     Mark every unread notification in the active workspace as read for the current user. API-key scope: `notifications:write`.

     account workspace

140. pm_mark_notification_read会改数据

     Mark a single notification as read. Only the notification owner may do this — calling with another user's notification identifier returns an error. API-key scope: `notifications:write`.

     identifier account workspace

141. pm_read_activity_log只读

     Read the activity log for a scope. `scope` selects the entity type and `identifier` is that entity's identifier (use the workspace identifier when scope=workspace). `mode` is either 'full' (this entity AND everything beneath it) or 'own' (this entity only). Cursor-paginated. WARNING: every entry has a `data` field that is a JSON-encoded STRING — to inspect the payload you must double-parse it (parse the response, then JSON.parse(entry.data)). API-key scope: `activity_log:read`.

     scope identifier mode cursor size account workspace

142. pm_remove_comment_reaction会改数据

     Remove a reaction by identifier. Only the user who added the reaction may remove it. 204. API-key scope: `tasks:write`.

     taskIdentifier commentIdentifier reactionIdentifier account workspace

143. pm_remove_tasks_from_sprint会改数据

     Remove task-sprint associations. Tasks remain in their lists. Pass identifiers (tsk_…), not task keys. Returns updated SprintDTO. API-key scope: `sprints:write`.

     sprintIdentifier taskIdentifiers account workspace

144. pm_remove_team_member会改数据

     Remove a single user from a team. Returns 204. Requires MANAGE_TEAMS. API-key scope: `teams:write`.

     identifier userUuid account workspace

145. pm_remove_workspace_member会改数据

     Remove a member from the workspace. NOTE: the target user UUID is passed as the `deletionUserUuid` QUERY parameter, not in the path or body. Caller needs MANAGE_USERS permission. Cannot remove the workspace owner — transfer ownership first via pm_transfer_workspace_ownership. Returns 204. API-key scope: `workspaces:write`.

     deletionUserUuid account workspace

146. pm_replay_webhook_delivery会改数据

     Re-send a specific past delivery to the webhook URL. Useful when the subscriber was down during the original attempt window or you need to re-trigger downstream processing. A replay re-sends the stored payload bytes, so it keeps the original envelope `id` and `eventId`: subscribers MUST treat a repeated eventId as a duplicate. The X-Webhook-Delivery header carries the new delivery id of the replay, so it differs from the envelope `id`. Every replay re-checks access first: a wiki or feature-request event whose item the webhook creator can no longer see is not replayed (404). API-key scope: `webhooks:write`.

     webhookIdentifier deliveryIdentifier account workspace

147. pm_save_filter会改数据

     Create a new saved filter on a list. Body is a FilterAggregateDTO with structured `filterGroups` — each group has a `precedingLogic` (AND/OR) and a list of filters. Each filter has `field`, `operator` (one of: is, equals, not, not_equals, like, greater_than, less_than, greater_or_equal, less_or_equal, is_set, is_not_set, in, not_in), `value`, optional `precedingLogic`, and `isCustomField` flag. Max 10 groups, max 20 filters per group. No PATCH/PUT exists — to edit, delete + re-create. API-key scope: `filters:write`.

     listIdentifier name filterGroups account workspace

148. pm_search_tasks只读

     Search tasks across the workspace with name-based filters. status / priority / tag / taskType are repeatable (pass an array). assignee is an email or UUID. q is a free-text search over title + description. Returns a cursor-paginated page of LiteTaskResponse — pass nextCursor back as `cursor` to paginate. Present title linked to webUrl; show displayKey only when non-empty. key and identifier are API references, not display labels. API-key scope: `tasks:read`.

     status priority tag taskType assignee parent q space listIdentifier includeSubtasks includeClosed limit cursor account workspace

149. pm_send_invitation会改数据

     Send an email invitation to join the current workspace. `workspaceAccessLevelId` is a numeric Long id (NOT a name like "admin"/"member") — fetch the catalogue from /v1/workspaces/{ws}/access-levels to translate role names to ids before calling. Caller needs MANAGE_USERS permission. Returns 201 on success. API-key scope: `users:write`.

     email workspaceAccessLevelId account workspace

150. pm_set_default_task_type会改数据

     Set the task type new tasks get when they are created without one, on a list, folder or space. A new task takes the default of its list, then folder, then space. `taskType` is a name (e.g. "Bug") or identifier, or null to clear this level so it inherits from the level above. Existing tasks keep their type; use pm_bulk_change_task_type for those. Get the list, folder or space identifier from pm_get_workspace_context. API-key scope: `lists:write`, `folders:write` or `spaces:write` for the level changed, plus `workspaces:read` to look up the type. Returns {container, identifier, taskType, taskTypeIdentifier}.

     container identifier taskType account workspace

151. pm_start_sprint会改数据

     Transition a sprint from NOT_STARTED to IN_PROGRESS. Only ONE sprint per group can be IN_PROGRESS at a time — starting a sprint while another is in progress will fail. No body. API-key scope: `sprints:write`.

     sprintIdentifier account workspace

152. pm_test_webhook会改数据

     Fire a synthetic test delivery to a webhook on demand, without waiting for a real workspace event. PM POSTs a `webhook-test` event with body {"test": true, "message": "This is a test webhook delivery"} to the registered URL, signed with the same X-Webhook-Signature-256 HMAC as live deliveries. Use this to verify a receiver is reachable and that your HMAC signature-verification is correct when setting up two-way communication. Returns the resulting delivery record (status, attempt, timestamps) — inspect it (or pm_list_webhook_deliveries) to confirm the endpoint accepted it. API-key scope: `webhooks:write`.

     webhookIdentifier account workspace

153. pm_transfer_workspace_ownership会改数据

     Transfer workspace ownership to another existing member. Only the current owner can do this, and the target user must already be a member. `resultingOwnerAccessLevelId` is the numeric access-level id the CURRENT (departing) owner will keep — typically a regular admin/member level. Discover access-level ids via /v1/workspaces/{ws}/access-levels. API-key scope: `workspaces:write`.

     transferToUserUuid resultingOwnerAccessLevelId account workspace

154. pm_update_automation会改数据

     Update an existing automation. All fields except `identifier` are optional — only specified fields change. `triggers`, `actions`, and `conditionNodes`, when present, REPLACE the existing collection (not append). Use `active: false` to disable without deleting. API-key scope: `automations:write`.

     identifier name description active triggers actions conditionNodes account workspace

155. pm_update_current_user会改数据

     Update the current user's profile. Today the request body has a single field (`fullName`) — pass the new display name. Returns the updated TaskManagementUserDTO. API-key scope: `users:write`.

     fullName account workspace

156. pm_update_custom_field会改数据

     Update custom-field metadata (name / description / emoji / color / isPrivate). API-key scope: `custom_fields:write`.

     identifier name description emoji color isPrivate account workspace

157. pm_update_folder会改数据

     Update folder metadata by identifier (fld_…). All fields optional. API-key scope: `folders:write`.

     identifier name description icon color isPrivate account workspace

158. pm_update_list会改数据

     Update list metadata by identifier (tl_…). All fields optional. API-key scope: `lists:write`.

     identifier name description icon color isPrivate account workspace

159. pm_update_notification_channel会改数据

     Turn individual Codexum (wiki) or Roadmarq (feedback) notifications on or off for one delivery channel (app, email or browser) of the current user. Pass `settings` as a map of setting key to true|false; only the keys you send change, the others keep their value (every key starts on). Codexum keys: pageUpdated, pageSharedWithMe, mentionedInPage, pageComments. Roadmarq keys: newFeedback, feedbackStatusChanged, feedbackVotes, feedbackComments. Returns the whole channel after the update: `{settings: {key: true|false}}` with every key of the module. pm_get_notification_settings shows the current values. Project Management notifications are not changed here: PM uses PUT /v1/users/settings/notifications/{channel}, which this server does not expose as a tool. API-key scope: `users:write`.

     module channel settings account workspace

160. pm_update_sprint会改数据

     Full update of sprint name, goal, and date window. NOTE: this is a PUT, not a PATCH — fields you omit may be cleared by the backend. Pass every field you want to keep. API-key scope: `sprints:write`.

     sprintIdentifier name goal startDate endDate account workspace

161. pm_update_tag会改数据

     Rename or recolor an existing tag. All updatable fields are optional — pass only what you want to change. The tag identifier stays the same; any task already tagged keeps the new name and colors automatically. API-key scope: `tags:write`.

     identifier name backgroundColor textColor account workspace

162. pm_update_task会改数据

     Partial-update a task by ref. Only fields present in the call are changed. Pass an explicit null to clear nullable fields (dueDate, parent, taskType, etc.). Names resolve leniently against the current effective set. To change just the type and nothing else, prefer this with `taskType` set; use `pm_bulk_change_task_type` when changing many tasks at once. API-key scope: `tasks:write`.

     ref title description list parent nextTo status priority level taskType tags assignees customFields startDate dueDate estimatedTime timeSpent isPrivate account workspace

163. pm_update_task_comment会改数据

     Update an existing comment. Only the original author may edit. API-key scope: `tasks:write`.

     ref commentIdentifier text mentions account workspace

164. pm_update_team会改数据

     Update a team's metadata or replace its full member list. All fields are optional — only specified fields change. NOTE: `memberUuids`, if present, REPLACES the existing membership (not appends). Use pm_add_team_member / pm_remove_team_member for incremental changes. Requires the workspace MANAGE_TEAMS permission. API-key scope: `teams:write`.

     identifier name alias description icon color memberUuids account workspace

165. pm_update_view会改数据

     Update a view, including the auto-created primary List view when finishing list setup. Configure useful column order, grouping, and sorting instead of leaving a defaults-only view. filters / columns use FilterGroupDTO / ColumnOrderItem shapes. Sending columns replaces the entire selection/order: include every native and custom field that should remain visible. Use raw custom-field identifiers from pm_get_workspace_context. Header icons belong in custom-field emoji/color metadata. Read back the rich resource-view configuration for verification; Lite GET/list responses omit columns and filters. API-key scope: `views:write`.

     identifier name isPrivate groupBy sortBy sortDirection filters columns account workspace

166. pm_update_webhook会改数据

     Partial-update a webhook subscription. Only fields present in the call are changed (pass-through PATCH-style semantics). Use `active: false` to pause deliveries without deleting. Updating eventTypes replaces the full subscribed set. Pass `secret` to rotate the HMAC signing secret: it is stored exactly as given and never returned, so keep your copy. Resuming (`active: true`) re-checks the stored URL. Re-scope with scopeType plus scopeEntityIdentifier (same values as pm_create_webhook), or pass `clearScope: true` to make the webhook workspace-wide again. includeSecurityBugs sets whether feature-request security bugs are delivered; omit it to keep the stored value. An API key can turn it off but not on (403): only a workspace admin signed in as a person can turn it on. The URL must be publicly reachable: Dutify refuses private, loopback, link-local, CGNAT and IPv6 ULA addresses, localhost, bare hostnames and *.svc / *.cluster.local names (400 WEBHOOK_URL_NOT_ALLOWED) at create, update and

     webhookIdentifier url name secret eventTypes active scopeType scopeEntityIdentifier clearScope includeSecurityBugs account workspace

167. whoami只读

     Unified Dutify whoami: fresh credential/workspace discovery. Does not require a selected workspace or reserve quota.

     account workspace

168. wiki_check_public_slug只读

     Check whether a public URL slug is available and validly formatted for a space, before publishing. Returns a SlugAvailabilityDTO. Call this when choosing a `customSlug` for wiki_set_public_settings. Requires space admin. API-key scope: `wiki:spaces:read`.

     spaceKey slug account workspace

169. wiki_confirm_attachment会改数据

     Step 3 of uploading: confirm that the bytes were successfully PUT to the presigned `uploadUrl`, activating the attachment. Returns the WikiAttachmentDTO (status becomes "confirmed"). Call only after the byte PUT succeeded. API-key scope: `wiki:attachments:write`.

     pageId attachmentId account workspace

170. wiki_create_page

     Create a wiki page under a space. Pass EITHER `markdown` (simpler, server converts to TipTap) OR `content` (TipTap/ProseMirror JSON, mutually exclusive with markdown). Use `content` when you need rich features that markdown can't express — banners, collapsibles, mermaid diagrams, action buttons, inline labels, mentions, code blocks with language, etc. For the full TipTap doc shape and a copy-friendly reference of every node and mark, call `get_endpoint_examples` with tag="Wiki Pages (Lite)" (and optionally name="full-tiptap"). Optional parent slug to nest under another page. Returns the created page DTO. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:pages:write`.

     spaceKey title markdown content parent icon account workspace

171. wiki_create_space

     Create a new wiki space in the current workspace. `key` is the unique short identifier used in URLs and subsequent API calls — uppercase letters + digits only, 2-20 chars, must start with a letter (e.g. "DOCS", "ENG2"). `name` is the human display name. Defaults: `isPublic: true` (INTERNAL visibility — all workspace members can view), `isEditPublic: false`. NOTE: `isPublic` is internal workspace visibility ONLY; it does NOT publish the space to the public web — use wiki_set_public_settings for that. Requires workspace-level edit access. API-key scope: `wiki:spaces:write`.

     key name description isPublic isEditPublic icon iconColor account workspace

172. wiki_delete_attachment会改数据

     Permanently delete an attachment and its stored file (returns 204). Useful for cleaning up unused or leftover uploads. This does not remove image nodes that still reference it in a page body — update the page content separately if needed. API-key scope: `wiki:attachments:write`.

     pageId attachmentId account workspace

173. wiki_delete_page会改数据

     Archive (soft-delete) or permanently delete a wiki page by slug. Falls through to the non-lite Wiki Pages API since there is no lite delete endpoint — path is `DELETE /v1/workspaces/{workspaceIdentifier}/wiki/spaces/{spaceKey}/pages/{slug}` with optional `?permanent=true`. Default behavior archives the page (soft delete); pass `permanent: true` to hard-delete (requires admin access). Returns 204 on success. API-key scope: `wiki:pages:write`.

     spaceKey slug permanent account workspace

174. wiki_delete_space会改数据

     PERMANENTLY delete a wiki space AND every page inside it. Requires admin access to the space. This is destructive — surface a clear confirmation to the user before calling. Returns 204. API-key scope: `wiki:spaces:write`.

     spaceKey account workspace

175. wiki_disable_page_share会改数据

     Disable the public share link for a single page, revoking access via its URL (returns 204). Requires edit access. API-key scope: `wiki:pages:write`.

     spaceKey slug account workspace

176. wiki_enable_page_share会改数据

     Enable a public SHARE LINK for a single page, returning a PublicShareInfoDTO with the `publicUrl` to hand out. Optional `token` sets a custom URL slug (3-100 chars, lowercase letters/digits/hyphens; 409 if already taken — omit to auto-generate). Optional `showAuthor` toggles author display. ⚠️ OUTWARD-FACING: anyone with the link can read this page — confirm with the user before enabling. Requires edit access. API-key scope: `wiki:pages:write`.

     spaceKey slug token showAuthor account workspace

177. wiki_get_page只读

     Get a wiki page by slug within a space. Default format is Markdown (the body is returned under the `markdown` field); pass format="tiptap" for raw ProseMirror JSON. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:pages:read`.

     spaceKey slug format account workspace

178. wiki_get_page_share只读

     Get the public SHARE-LINK status for a single page (PublicShareInfoDTO): `isEnabled`, `publicToken`, `publicUrl` (the shareable link), `showAuthor`, `sharedAt`, `sharedBy`, `workspaceAllowsSharing`. A per-page share link lets anyone with the URL read just that one page — distinct from publishing a whole space (wiki_set_public_settings). Requires edit access. API-key scope: `wiki:pages:read`.

     spaceKey slug account workspace

179. wiki_get_public_settings只读

     Get a space's PUBLIC-WEB publishing settings (PublicSpaceSettingsDTO): `isEnabled` (is the space published to the public internet), `customSlug` (public URL slug), `allowedEmojis`, `showReactions`, `showPageViews`, `showLastUpdated`, `showAuthor`, `viewMode` ("space"|"helpcenter"), `heroTitle`, `heroSubtitle`. This is SEPARATE from the space's `isPublic` flag, which is internal workspace visibility only. Requires space admin. API-key scope: `wiki:spaces:read`.

     spaceKey account workspace

180. wiki_get_space只读

     Fetch a single wiki space by key. Returns the WikiSpaceDTO (id, key, name, description, icon, color, cover image, visibility flags, permissions, timestamps). For the page tree inside the space, use wiki_get_space_with_pages instead. API-key scope: `wiki:spaces:read`.

     spaceKey account workspace

181. wiki_get_space_with_pages只读

     Fetch a wiki space AND its complete page tree in one call. Returns WikiSpaceWithPagesDTO — space metadata plus `pages` (a recursive tree of WikiPageTreeNodeDTO with slug, title, type=page|folder, hasChildren, children[], view count, top reactions, the caller's effectivePermission per node). Use this to render or traverse the whole space; for a single level (root or one parent's children) wiki_list_pages is lighter. API-key scope: `wiki:spaces:read`.

     spaceKey account workspace

182. wiki_list_attachments只读

     List every attachment on a wiki page (WikiAttachmentDTO[]): id, pageId, filename, contentType, sizeBytes, status (pending|confirmed|failed), uploadedBy/At, confirmedAt. `pageId` is the page UUID (from wiki_get_space_with_pages tree node `id`, not the slug). Use to find an attachmentId to reference or delete. API-key scope: `wiki:attachments:read`.

     pageId account workspace

183. wiki_list_pages只读

     List wiki pages in a space. Without `parent` returns root-level pages; pass a parent slug to list that page's children. Response items have slug, title, status, type (page|folder), parentSlug, updatedAt — no bodies. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:pages:read`.

     spaceKey parent limit account workspace

184. wiki_list_spaces只读

     List every wiki space the caller can see in the current workspace. Each entry has the space's `key` (use this in subsequent calls), `name`, `description`, `effectivePermission` (view/edit/admin), and `canView`/`canEdit`/`canAdmin` booleans for quick gating. Call this first when an agent needs to figure out which space a wiki action should target. API-key scope: `wiki:spaces:read`.

     account workspace

185. wiki_move_page会改数据

     Move a wiki page to a new parent and/or a new space. All body fields are optional and use slugs (resolved server-side in the target space) instead of UUIDs: `targetSpaceKey` for cross-space moves (omit to stay in the current space); `newParent` is the slug of the new parent page (omit/null to move to space root); `afterPage` is the slug of the sibling page to insert after (omit/null to place first). Returns the moved page DTO. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:pages:write`.

     spaceKey slug targetSpaceKey newParent afterPage account workspace

186. wiki_request_attachment_upload

     Step 1 of uploading an image/file to a wiki page. Returns { attachmentId, uploadUrl, storageKey }. AFTER calling this you MUST: (2) PUT the raw file bytes to `uploadUrl` with your OWN HTTP client — the MCP server cannot do this binary upload — sending the EXACT same `Content-Type` as `contentType` and a `Content-Length` equal to `sizeBytes` (both are baked into the presigned URL; a mismatch 403s); then (3) call wiki_confirm_attachment to activate it. To embed the result as an image, add a TipTap image node with no `src` — { type:"image", attrs:{ attachmentId, pageId, width, height, align } }, width <= ~660 and height proportional — via wiki_update_page (content payload). Do NOT embed base64 data: URIs; they render distorted. Max 25 MB; system-executable file types are rejected. `pageId` is the page UUID (wiki_get_space_with_pages tree node `id`). API-key scope: `wiki:attachments:write`.

     pageId filename contentType sizeBytes account workspace

187. wiki_retrieve只读

     Search the wiki by MEANING and get back the most relevant PASSAGES (chunks) with citations and relevance scores. Use this to GROUND or ANSWER a question from wiki content: it returns quotable chunkText plus the source page/section so you can cite it. Each result has pageSlug, pageTitle, spaceKey, spaceName, chunkIndex, headingPath (heading-path breadcrumb), chunkText, score (0..1, higher = more relevant), status and updatedAt. This is retrieval-augmented generation (RAG) over wiki content, NOT a page finder — to merely LOCATE or LIST pages by title/keyword use wiki_search. Defaults to the top 5 chunks; pass limit to widen. Fails open to keyword retrieval if the embedding provider is unavailable. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:search:read`.

     query spaceKey limit account workspace

188. wiki_search只读

     Find wiki PAGES by title/keyword in the current workspace. Returns a list of matching pages (slug, title, spaceKey, spaceName, excerpt, status, updatedAt) — no UUIDs, no full body. Use this to LOCATE or LIST pages (then call wiki_get_page to read one). To ANSWER a question FROM wiki content — i.e. get back quotable passages with citations and relevance scores — use wiki_retrieve instead. Optionally scope to a single space by passing spaceKey. Defaults to hybrid (keyword + semantic) ranking; pass mode to override. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:search:read`.

     q spaceKey limit mode account workspace

189. wiki_set_public_settings会改数据

     Publish / unpublish a space to the PUBLIC INTERNET, or update its public-site config. This is the REAL publish switch — NOT the space `isPublic` flag (which is internal visibility). Pass only the fields you want to change: `isEnabled` (true = publish to the web, false = take offline), `customSlug` (public URL slug — validate first with wiki_check_public_slug), `allowedEmojis` (string[]), `showReactions`, `showPageViews`, `showLastUpdated`, `showAuthor`, `viewMode` ("space"|"helpcenter"), `heroTitle`, `heroSubtitle`. Provided fields are merged onto the current settings (read-modify-write), so unspecified fields are preserved. Minimal publish: { isEnabled: true, customSlug: "my-docs" }. ⚠️ HIGH-TRUST / OUTWARD-FACING: enabling makes the space readable by ANYONE on the internet — confirm with the user before publishing. Requires space ADMIN. API-key scope: `wiki:spaces:write`.

     spaceKey isEnabled customSlug allowedEmojis showReactions showPageViews showLastUpdated showAuthor viewMode heroTitle heroSubtitle account workspace

190. wiki_update_page会改数据

     Update an existing wiki page by slug. Any field left unset preserves the current value. Pass EITHER `markdown` OR `content` (TipTap/ProseMirror JSON) for the body — they're mutually exclusive. Use `content` for rich features (banners, collapsibles, mermaid, etc.); call get_endpoint_examples(tag="Wiki Pages (Lite)") for the full doc shape. Page results include webUrl: a browser link requiring normal workspace access. Use it for citations; it does not make the page public. API-key scope: `wiki:pages:write`.

     spaceKey slug title markdown content account workspace

191. wiki_update_space会改数据

     Update a wiki space's metadata. All fields are optional — pass only what you want to change. The space key cannot be changed. Requires edit access to the space. API-key scope: `wiki:spaces:write`.

     spaceKey name description isPublic isEditPublic icon iconColor account workspace