Duvo MCP
io.github.duvoai/duvo · v2026-05-24 · MCP 2025-11-25
Governed retail, FMCG, and CPG operational tools: runs, cases, approvals, audit-ready execution.
Reachability
reachable
checked 2026-11-21 07:21 UTC
Registry status active
Tools pinned 393
b41bb7f645ec
Tools last changed
2026-11-21
Provenance
Registry namespace io.github.duvoai
(GitHub-account verified by the official registry)
Repository
github.com/duvoai/duvo-website-2026
repo gone
Website
https://www.duvo.ai
Remote endpoints
https://api.duvo.ai/v1/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 07:21 | tools changed | 1 added, 0 removed, 4 changed |
| 2026-11-19 07:16 | tools changed | 0 added, 2 removed, 0 changed |
| 2026-11-18 07:19 | tools changed | 0 added, 0 removed, 6 changed |
| 2026-11-17 07:14 | tools changed | 0 added, 0 removed, 9 changed |
| 2026-11-13 07:12 | tools changed | 0 added, 0 removed, 4 changed |
| 2026-11-10 07:09 | tools changed | 2 added, 0 removed, 2 changed |
| 2026-11-07 07:01 | tools changed | 0 added, 0 removed, 4 changed |
| 2026-11-06 07:02 | tools changed | 0 added, 0 removed, 4 changed |
| 2026-11-05 07:02 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-04 07:01 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-11-03 07:01 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-10-31 06:54 | tools changed | 0 added, 0 removed, 7 changed |
| 2026-10-30 06:56 | tools changed | 0 added, 9 removed, 0 changed |
| 2026-10-28 06:59 | tools changed | 2 added, 0 removed, 4 changed |
| 2026-10-27 06:53 | tools changed | 3 added, 3 removed, 2 changed |
| 2026-10-23 06:51 | tools changed | 0 added, 3 removed, 7 changed |
| 2026-10-22 06:47 | tools changed | 1 added, 0 removed, 1 changed |
| 2026-10-21 06:48 | tools changed | 2 added, 0 removed, 8 changed |
| 2026-10-20 06:57 | tools changed | 6 added, 0 removed, 58 changed |
| 2026-10-17 06:38 | tools changed | 0 added, 0 removed, 3 changed |
| 2026-10-16 06:44 | tools changed | 0 added, 0 removed, 4 changed |
| 2026-10-15 06:36 | tools changed | 0 added, 0 removed, 32 changed |
| 2026-10-13 06:40 | tools changed | 0 added, 7 removed, 15 changed |
| 2026-10-10 06:33 | tools changed | 0 added, 0 removed, 2 changed |
| 2026-10-09 06:35 | tools changed | 0 added, 0 removed, 6 changed |
Pinned tool definitions (393)
| Tool | Description |
|---|---|
| listAgentMemoryFiles | List the memory files stored for an agent. |
| getAgentMemoryFile | Get the contents of a single memory file for an agent. |
| listPluginCatalog | List plugins that can be referenced by name in a build's plugins array. Builds may also reference any public GitHub repository URL (https://github.com/owner/repo) as a plugin; those are not enumerated here. |
| createSchedule | Create a schedule for an agent. The schedule fires against the agent's live build. The authenticated user owns the schedule. On a team with revisions, a repeating schedule for an Agent in an automation joins that automation's revisions:... |
| updateSchedule | Update fields on an existing schedule. Only supplied fields are changed; omitted fields retain their current values. Owners may update their own schedules; team superadmins may update any schedule on agents in the current team. A... |
| deleteSchedule | Delete a schedule. Owners may delete their own schedules; team superadmins may delete any schedule on agents in the current team. Deleting a schedule that belongs to an automation with revisions stops it for its owner at once; the... |
| getTeam | Get a team by ID. The caller must be scoped to the requested team. |
| startNativeOAuth | Start an OAuth-based connection with a native provider (Gmail, Google Sheets, Outlook, etc.). The provider path parameter is the native OAuth provider key from listIntegrations, not the integration type. Returns an authorization URL... |
| authorizeMcpOAuth | Start an OAuth-based connection with a remote MCP server. Returns an authorization URL the user must open in a browser; once they grant consent, Duvo creates the matching connection and redirects the browser to the optional... |
| checkMcpOAuth | Probe an MCP server URL to discover whether it supports OAuth Dynamic Client Registration. Returns the authorization endpoint and required scopes when supported. Useful as a precursor to `/v2/teams/:team_id/connections/oauth/mcp/start`... |
| listPulseDashboards | List your Duvo Pulse dashboards (live, agent-generated visualizations of your Duvo data). Ordered most recently updated first, except scope=automation, which is ordered by creation time (then id) so the whole scope can be read with the... |
| createPulseDashboard | Create a new Duvo Pulse dashboard from a natural-language prompt (e.g. 'open cases by queue this week') and dispatch the first generation turn. Generation is asynchronous — poll GET /artifacts/{artifactId} until status is completed. The... |
| getPulseDashboard | Get a Duvo Pulse dashboard's metadata and generation status. When status is completed and html_code_present is true, fetch the rendered HTML from GET /artifacts/{artifactId}/render; the conversation is served by GET... |
| getPulseDashboardHtml | Serve a Duvo Pulse dashboard's rendered HTML document (text/html, not JSON). 404 until the first generation turn has produced HTML. |
| getPulseDashboardPdf | Render a Duvo Pulse dashboard to a PDF document (application/pdf, not JSON). 404 until the first generation turn has produced HTML; 409 for an openui dashboard, whose substrate this exporter cannot render. |
| exportPulseDashboardHtml | Render a Duvo Pulse dashboard to a self-contained static HTML snapshot (text/html, data baked in). 404 until the first generation turn has produced HTML; 409 for an openui dashboard, whose substrate this exporter cannot render. |
| updatePulseDashboard | Update a Duvo Pulse dashboard's settings — rename it. Only the creator can update it. |
| publishPulseDashboard | Publish (share) a Duvo Pulse dashboard to your whole team or your whole organization, or revert it to private (creator only). When publishing, set permission to 'view' (teammates see the dashboard) or 'edit' (teammates can also iterate... |
| deletePulseDashboard | Delete a Duvo Pulse dashboard. Only the creator can delete it. |
| duplicatePulseDashboard | Duplicate a Duvo Pulse dashboard, producing an idle clone of the current rendered dashboard. The conversation history, shares, and connections are not copied. |
| sendPulseDashboardMessage | Send an instruction to iterate on a Duvo Pulse dashboard (e.g. 'make it a bar chart', 'filter to last 14 days'). The creator can always iterate; teammates can too when the Pulse is published to the team with edit access. The agent... |
| createPulseDashboardAttachmentUploadUrl | Issue a presigned upload URL for a file to attach to a Duvo Pulse dashboard message (e.g. an HTML dashboard to copy, or a screenshot to match). POST the file bytes to the returned upload_url as multipart form data under the field name... |
| getPulseDashboardAttachmentDownloadUrl | Mint a short-lived presigned URL to download or preview a file attached to a Duvo Pulse dashboard message. Returns 410 with code `sandbox_expired` once data retention deleted the dashboard's sandbox, and 404 when the file is otherwise gone. |
| refreshPulseDashboard | Trigger an on-demand data refresh of a Duvo Pulse dashboard. The dashboard regenerates its connection-sourced values in the background — poll GET /artifacts/{artifactId} for status. |
| stopPulseDashboardMessage | Stop an in-flight Duvo Pulse generation turn. Requires edit access to the dashboard. Flips the dashboard to 'interrupted' and keeps any streamed-so-far reply; stopping when nothing is generating is a successful no-op. |
| listPulseDashboardConnections | List the connections (data sources) attached to a Duvo Pulse dashboard (requires edit access). |
| attachPulseDashboardConnection | Attach one of your connections (data sources) to a Duvo Pulse dashboard so the agent can use its tools (requires edit access). |
| detachPulseDashboardConnection | Detach a connection (data source) from a Duvo Pulse dashboard (requires edit access). |
| answerPulseDashboardQuestion | Answer a pending question the Duvo Pulse agent asked and resume the paused run (creator or team editors). Use the toolCallId from the dashboard's message transcript. |
| listPulseDashboardMessages | List the chat transcript of a Duvo Pulse dashboard's live version (requires edit access). Returns the most recent page by default, oldest first within the page; pass `before` (a message id from a previous page) to walk back through... |
| listPulseDashboardComments | List the comment threads on a Duvo Pulse dashboard (requires view access). Each thread carries its author, the dashboard element it is pinned to, its replies oldest-first, and whether it has been marked complete. |
| createPulseDashboardComment | Start a comment thread on a Duvo Pulse dashboard (requires view access). Pass `element` — captured from the dashboard canvas — to pin the thread to one element; omit it for a comment on the dashboard as a whole. |
| createPulseDashboardCommentReply | Reply to a comment thread on a Duvo Pulse dashboard (requires view access). `commentId` must be a thread root; threads are one level deep. A thread already marked complete still accepts replies and stays complete. |
| setPulseDashboardCommentResolution | Mark a Duvo Pulse dashboard comment thread complete, or reopen it (requires view access). Pass the target state in `resolved`; the call is idempotent, and the response carries the thread with `resolved_at` and `resolved_by` set or cleared. |
| deletePulseDashboardComment | Delete a comment or reply on a Duvo Pulse dashboard. Allowed for the comment's author and for the dashboard's creator. Deleting a thread root keeps its replies, rendered under a deleted opening comment. |
| listPulseDashboardVersions | List the version history of a Duvo Pulse dashboard, newest first (requires edit access). Use the version id with the restore and version-render endpoints. |
| getPulseDashboardVersionHtml | Serve a specific version's rendered HTML document for a Duvo Pulse dashboard (text/html, requires edit access). |
| restorePulseDashboardVersion | Restore a previous version of a Duvo Pulse dashboard, making it live again (requires edit access). Non-destructive — it moves the head pointer to the chosen version. |
| createSandbox | Create a new sandbox for file uploads. The returned sandbox_id can be passed to POST /v2/teams/:team_id/runs to stage data for a run. |
| createSandboxUploadUrl | Get a presigned URL for uploading a file into a sandbox. Use for files larger than 10MB; smaller files can be uploaded directly via POST /v2/sandboxes/:sandbox_id/files. |
| listSandboxFiles | List files in a sandbox directory. |
| uploadSandboxFile | Upload a file directly to the sandbox. Maximum file size is 10MB. For larger files, use POST /v2/sandboxes/:sandbox_id/upload-urls. |
| getRunEvaluation | Get the latest evaluation analysis for a specific agent run (Run). |
| getEvalScores | Aggregate evaluation counts and flag distribution for an Assignment's Jobs since the given timestamp. |
| getEvalRubrics | List the evaluation rubrics a Run is scored against: the platform default rubrics plus the Agent-specific rubrics for a build. Defaults to the Agent's live build; pass build_id to target the revision a specific Run ran against. |
| createEvalRubric | Add one Agent-specific evaluation rubric to a build. A build may hold at most 5 custom rubrics by default (25 on teams with the newer rubric generator enabled); this fails with 409 once the build's ceiling is reached, and the error... |
| replaceEvalRubrics | Replace a build's entire Agent-specific evaluation rubric set in one call (at most 5 rubrics by default, 25 on teams with the newer rubric generator enabled). Existing custom rubrics are removed and the supplied list becomes the new... |
| updateEvalRubric | Edit a single Agent-specific evaluation rubric's title and/or description. The edit produces a NEW rubric (with a new id and slug) so previously scored Runs stay attributed to the original criterion; the response contains the new rubric. |
| deleteEvalRubric | Remove a single Agent-specific evaluation rubric. Future Runs on the build are no longer scored against it. |
| listAgentSchedules | List the schedules you own on an agent. Returns only your own schedules, whoever you are. Callers with an elevated team role can read every member's schedules on the agent, including who created each one, via `GET... |
| listAllAgentSchedules | List every team member's schedules on an agent, including who created each one. Requires an elevated team role; callers without one receive 403 and should use `GET /agents/{agent_id}/schedules`, which returns only the schedules they own. |
| listAgentCaseTriggers | List the case triggers configured for an agent. Each trigger automatically dispatches the agent to run cases added to a queue. |
| previewAgentCaseTriggerConflicts | Preview which other agents would conflict with this agent's case trigger if it pointed at the given queue. Does not modify the trigger. |
| getAgentCaseTrigger | Retrieve a single case trigger by id. |
| createAgentCaseTrigger | Create a case trigger for an agent. An agent may have at most one case trigger; this returns 409 if one already exists. |
| updateAgentCaseTrigger | Update fields on a case trigger. Only the trigger creator or a builder/admin can disable an enabled trigger or change its queue, and only a builder/admin can change queue concurrency. |
| deleteAgentCaseTrigger | Delete a case trigger. Only the trigger creator or a builder/admin can delete it. |
| listAgentTriggers | List the trigger definitions the authenticated user owns on an agent (Agent in the Duvo UI). Triggers start a Run automatically when an external event fires (e.g. an email arrives or a Linear issue is created). |
| upsertAgentTrigger | Create or update the authenticated user's trigger for an integration on an agent. The integration must already be connected to the agent (its OAuth connection set up in the Duvo dashboard). Set `enabled: false` to pause a trigger... |
| deleteAgentTrigger | Permanently delete one of your own event triggers on an agent. The agent stops starting Runs for that event and the trigger's filter config is lost. To keep the trigger but stop it firing, upsert it with `enabled: false` instead. |
| listAgentTriggerTypes | List the trigger types available for an agent, grouped by integration. Use the returned `integration_slug` and `trigger_type` values when creating a trigger. |
| createAgentSlackTrigger | Create a Slack channel trigger on an agent (Agent in the Duvo UI): the agent starts a Run whenever a matching message is posted in the channel. An agent can carry one trigger per channel, so call this once per channel. The Slack... |
| listAgentSlackTriggers | List the Slack channel triggers you own on an agent (Agent in the Duvo UI), oldest first. Each trigger's `filter_config` carries the watched `channelId`, `channelName`, Slack `workspaceId`, and `matchRule`. Capped at 100 triggers per agent. |
| updateSlackTrigger | Update a Slack channel trigger you own — repoint it at another channel, change which messages match, or pause and resume it with `enabled`. Only the supplied fields change. Resuming a paused trigger requires the Slack connection it runs... |
| listAgentSlackBoundWorkspaces | List the Slack workspaces bound to an agent build that you can create channel triggers for. Creating a Slack channel trigger for any other workspace is rejected, so start here to pick a valid `slack_team_id` and `integration_instance_id`. |
| deleteSlackTrigger | Permanently delete a Slack channel trigger you own. The agent stops starting Runs for that channel. To keep the trigger but stop it firing, update it with `enabled: false` instead. |
| acceptRevisionGeneration | Accept the reviewed generated configuration and complete the builder run. The saved draft is not activated. |
| generateRevision | Generate agent instructions or code into a saved draft. Poll the returned builder run, answer questions if requested, then accept or decline the reviewed checkpoint. This never activates the revision. |
| promoteRevision | Promote a draft or historic revision to the live version. Before calling, confirm with the user which agent and revision will go live and that triggers and new runs will use it. The live revision is the one used by triggers and new... |
| resumeBuilderRun | Resume a builder run that is waiting for user input |
| cancelBuilderRun | Cancel a running builder run and pause its sandbox |
| createRevision | Create a new revision for an existing agent. |
| declineRevisionGeneration | Discard generated changes by restoring checkpoint_config and completing the builder run. The saved draft is not activated. |
| getRevision | Get a revision by ID. |
| getBuilderRun | Get the status of a builder run |
| getRevisionBody | Read one section of a revision's config as plain text, in character ranges: the AOP (`input`) or the code-step program (`source`). Use it instead of getRevision when the text is large; listAgents with `config=light` reports each agent's... |
| listAgentRevisions | List revisions for an agent. Pass `config=light` to leave each revision's config out of the page and get its sizes instead; read the AOP with getRevisionBody. |
| updateRevision | Update a revision's configuration, name, description, or handover targets. Returns the updated revision. |
| uploadCodeStepFile | Upload one UTF-8 file of a code step's program to the content-addressed store. Put the returned sha256 and sizeBytes entry in the revision's config source.bundle manifest (using the returned bucket) via updateRevision on a draft.... |
| duplicateAgent | Duplicate an existing agent into a new agent named "Copy of <name>", carrying over its configuration. Use the include_* flags in the (optional) body to control what is copied; all default on except memory. Builders can duplicate agents... |
| getAgent | Get an agent by ID. The response carries no revision config: use listAgentRevisions and getRevision for a revision, and getRevisionBody to read a large AOP in character ranges. |
| updateAgent | Update an agent's display name or delivery settings. |
| deleteAgent | Delete an agent and cascade-clean its schedules, case triggers, builder runs, and handover targets. Any active jobs are interrupted and their sandboxes paused. |
| moveAgent | Move an agent (and its connected workspace) to a different team. Pass dry_run=true to preview the closure without applying changes. |
| getAutomation | Get a single automation with its agent and queue counts, the tab arrangement its detail view navigates by, and `links` to each tab it has right now. |
| updateAutomation | Update an automation, e.g. rename it. Only the fields present in the body are changed. |
| generateAutomationProcessMap | Start the setup step Generate current process map for a Module automation being set up, the same as pressing it in the web app: Duvo writes the map of how the work runs today from the uploaded files, the interviews and the Policy.... |
| generateAutomationProposal | Approve the current process map of a Module automation being set up and start writing the automation proposal from it, the same as the setup's Approve and continue in the web app. The proposal says what Duvo automates, what stays with... |
| approveAutomationProposal | Approve the automation proposal of a Module automation being set up, the same as the setup's Approve and build in the web app: it opens an Ask Duvo conversation that reads the proposal and the Policy, proposes which Agents, Queues and... |
| getAutomationTabs | Get the automation detail view's tab arrangement, plus metadata for the Pulse dashboards pinned into it. Pinned dashboards are filtered to the ones the calling identity may see. |
| updateAutomationTabs | Replace the automation detail view's tab arrangement. Pinning, unpinning, reordering and hiding a tab are all expressed as a different arrangement. |
| deleteAutomation | Soft-delete an automation. Its member agents and queues stop dispatching and disappear from listings, but their underlying rows and run history are preserved (not erased). Runs still in progress on its agents are interrupted. |
| duplicateAutomation | Duplicate an automation into a new one named "Copy of <name>", copying what it runs today: its live agents and builds, its queues (empty), the routing and handovers between them, and each agent's Memory when the team holds Memory and... |
| getAutomationCurrent | Get what the automation is set up to do right now: its member agents with the builds that are live, its queues' routing, and the triggers and schedules firing for it. The revision-less counterpart of the revision detail — an automation... |
| getAutomationCurrentFlow | Get the automation's flow graph as it stands right now: the agents and queues it currently wires together, plus the producer, consumer, and handover edges between them. The revision-less counterpart of the revision flow. |
| getAutomationReadiness | What still has to be set up before an automation can run on real work. Call this first for a readiness question ("what do I still need to set up", "is it ready to run", "why isn't it running") and before checking an automation's... |
| readAutomationDashboardData | The figures a Module automation's Pulse dashboards show, computed server-side the same way the dashboard computes them: each tile's `label`, `value`, `unit` and `display` (the value as the dashboard prints it), with a `description`... |
| listProcessRoles | List the process roles of an automation (Operator, Executive, Approver and the like, defined on that one automation, not the team's Admin/Member/Builder roles) with what each can do and who holds it. Answer "who can see X", "who has... |
| assignProcessMember | Put one person on an automation in one of its process roles. Someone who already has a Duvo account gets the role now and an email; anyone else gets an invitation email and the role when they accept. In an organization that requires... |
| addAutomationAgent | Add an agent to an automation on a team that is on the Automations workspace, with or without revisions — membership is not versioned. The agent must not already belong to another automation; on a team that changes its automations by... |
| removeAutomationAgent | Remove an agent from an automation on a team that is on the Automations workspace, with or without revisions — membership is not versioned. Deleting the agent interrupts its active runs and pauses their sandboxes, exactly as a... |
| addAutomationQueue | Add a queue to an automation on a team that is on the Automations workspace, with or without revisions — membership is not versioned. The queue must not already belong to another automation; on a team that changes its automations by... |
| removeAutomationQueue | Remove a queue from an automation, deleting the queue. Its cases are cleared and the runs working them interrupted, exactly as a standalone queue delete does. Queue membership is not versioned, so this behaves the same whether or not... |
| listConfigFields | Read an automation's module config fields (its Policy), grouped by section in the automation's section order, with each field's current value, default, and fill provenance. |
| readAutomationPolicy | Read an automation's whole Policy before answering anything about it: every question by section, with its `id` (the field id updateConfigField takes), key, type, answer and who gave it; `counts.questions` as the Policy screen's header... |
| assignPolicyInterview | Assign a Policy interview: a Clarity voice interview covering the automation's open Policy questions, whose answers are written back onto them. Pass `invited_email` to email it to someone, and `context` to say who they are; leave... |
| updateConfigField | Set or clear a config field's value. `value: null` removes the answer and does not restore the module default, so a Run that reads the field is refused until it is answered again. To use the default, send `default_value` as `value`. On... |
| addConfigField | Add a Policy question to this automation. Its key is `custom_` plus the label in snake_case, with `_2`, `_3` and so on appended when the key is taken, and it is placed at the end of its section. A module template reinstall never changes... |
| updateConfigFieldDefinition | Edit a Policy question: its label, question, guidance, example answer, section, the roles that answer it, the options of a select or multiSelect field, and the columns of an unanswered table field a person added. A reworded question... |
| hideConfigField | Hide a Policy question from the Policy screen, interviews and every agent's context. Nothing is deleted: the answer and its history stay, and the restore operation shows it again. Returns the agents whose live version still reads the... |
| restoreConfigField | Show a hidden Policy question again, with the answer it had. |
| listConfigSections | List the sections of an automation's Policy in display order, empty ones included, each with its key, name, origin and question count. No offset/limit params: this is the automation's whole set of sections. |
| addConfigSection | Add an empty section to this automation's Policy, last or right after after_key. Its key is the name in lowercase words joined by hyphens, with `-2`, `-3` and so on appended when the key is taken. A name another section has, ignoring... |
| renameConfigSection | Rename a section of this automation's Policy. Its key and its questions stay as they are, and every reader shows the new name. A name another section has, ignoring case, is refused with a 409; the current name changes nothing. A module... |
| reorderConfigSections | Replace the display order of this automation's Policy sections. keys must list every section key of the automation exactly once, else a 400 names what is missing, unknown or repeated. Returns every section in its new order. A module... |
| removeConfigSection | Remove a section a person added to this automation's Policy, once it holds no question, hidden ones included. A section with questions, or one from the module template, is refused with a 409. Returns the removed section. |
| listRevisionIntegrations | List integrations attached to an agent revision. |
| attachRevisionIntegrations | Attach one or more integrations to an agent revision. To pin specific connections after attachment, use pinRevisionIntegrationConnection. IMPORTANT for the case-queue-producer and case-queue-consumer integrations: attaching the... |
| removeRevisionIntegration | Remove an integration from an agent revision. Removes the slot for everyone on the revision, including all per-user connection pins. Requires edit permission on the agent. |
| listRevisionIntegrationConnections | List the connections you have pinned to this build's integration slot. Multi-pin is supported: you can pin multiple connections to the same slot. |
| pinRevisionIntegrationConnection | Pin one of your connections (from GET /v2/teams/:team_id/connections) to this build's integration slot. Multi-pin is supported: a single user can pin multiple connections to the same slot. |
| unpinRevisionIntegrationConnection | Unpin one of your connections from this build's integration slot. The connection itself is not deleted; only the binding to this slot is removed. |
| getRevisionCaseQueueSetup | Check that this build's case-queue integration slots are wired up correctly. Returns, per case-queue-producer/consumer slot, how many queues are linked, plus whether any queue is available to bind (scoped to the agent's automation on a... |
| listRevisionIntegrationQueues | List the queues linked to this build's case-queue integration slot. Only meaningful for case-queue-producer and case-queue-consumer integrations. |
| replaceRevisionIntegrationQueues | Replace the set of queues linked to this build's case-queue integration slot. Send the full desired queue list — any queues not in the list will be unlinked. Requires edit permission on the agent. After linking, call... |
| listAgentSuggestions | List an Agent's suggestions. status=pending is the inbox; status=history is consumed/dismissed/auto-cleared. Reads lazily auto-clear stale pending items. |
| getAgentSuggestion | Fetch a single suggestion. Poll this after a 202 from consume: an AOP apply in flight reports payload.apply.state (running/failed); once consumed, applied_revision_id carries the draft revision the change was staged onto. |
| consumeAgentSuggestion | Apply a suggestion: stage its change into the Agent's draft revision, then auto-clear any pending suggestions it makes moot. |
| rejectAgentSuggestion | Dismiss a pending suggestion. |
| listSystemSkills | List all system skills (skills available to all teams). |
| deleteSkill | Delete a skill for the current team. |
| downloadSkill | Download a custom skill as a ZIP archive. Only custom (team-owned) skills can be downloaded. |
| listSkillFiles | List all files in a skill. |
| getSkillFileContent | Get the content of a file in a skill. |
| updateSkillFile | Update the content of a file in a skill, overwriting the active revision in place — the previous content is not recoverable. Prefer the non-destructive flow when you can: createSkillRevision to open a draft, updateSkillRevisionFile to... |
| listSkillAssignments | List the agents in the current team whose live build references the given skill. Used to warn users that editing a skill will affect every agent that uses it. |
| listSkillRevisions | List a skill's version history. Each revision is a snapshot of the skill's files; at most one is active (live) at a time, plus at most one open draft. |
| createSkillRevision | Open a draft revision of a skill, copying its files from the active revision (or from `source_revision_id`). Edit the draft with updateSkillRevisionFile and deleteSkillRevisionFile, then activate it with promoteSkillRevision — the... |
| promoteSkillRevision | Make a skill revision the active (live) one. The previously active revision becomes historic and can be re-activated later. Idempotent: promoting the already-active revision succeeds rather than erroring, and still applies any... |
| listSkillRevisionFiles | List the files in a skill revision, one page at a time. When `has_more` is true, pass `next_cursor` back as `cursor` to fetch the next page. |
| getSkillRevisionFileContent | Get the content of a text file in a skill revision. |
| updateSkillRevisionFile | Write a text file into a skill revision. Writing into a draft leaves the active revision untouched until the draft is promoted; writing into the active revision changes what the skill runs immediately. Historic revisions are read-only:... |
| deleteSkillRevisionFile | Delete a file from a skill revision. Deleting from a draft leaves the active revision untouched until the draft is promoted; deleting from the active revision changes what the skill runs immediately. SKILL.md can't be deleted. Historic... |
| updateSkillRevision | Rename a skill revision or change its description. Works for drafts, the active revision, and historic revisions. |
| deleteSkillRevision | Delete a draft or historic skill revision and its files. The active revision can't be deleted — activate another revision first. |
| getProfile | Get the profile of the authenticated user (the owner of the API key). |
| getLegacyClarityProcess | Get a legacy v1 Clarity process with process metadata, generated analysis, automation guidance, generation progress, and captures. Use this for rows from listClarityProcesses where version=1; v2 rows should use getClarityProcess and... |
| updateClarityProcess | Update a Clarity process name, guidance, interview independence, map settings, visibility, or completion status. Team Builders can edit names, guidance, interview independence, and map settings, only the creator or a team manager can... |
| listClarityProcessMembers | List users with accepted access to a clarity process, the people invited who have not accepted yet, and anyone else who has recorded a capture on it |
| removeClarityProcessMember | Remove accepted access to a clarity process |
| deleteClarityProcess | Delete a Clarity process. The creator or a team admin can delete it unless capture analysis is still in progress, or a Module runs it — a Module's process is part of the Module, so the Module has to be removed first. An automation built... |
| duplicateClarityProcess | Duplicate a Clarity process with its analysis, captures, message history, and, for v2 processes, its live current map and automation proposal. Requires a team manager role. |
| createClarityVideoUploadUrl | Create a signed URL for uploading a video file directly to GCS |
| completeClarityVideoUpload | Complete a video capture after uploading to GCS via signed URL |
| createClarityDocumentUploadUrl | Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, BPMN, XLSX, or CSV document directly to GCS |
| completeClarityDocumentUpload | Complete a document capture after uploading to GCS via signed URL |
| createClarityImageUploadUrl | Create a signed URL for uploading a PNG, JPEG, WebP, or SVG image directly to GCS |
| completeClarityImageUpload | Complete an image capture after uploading it to GCS via a signed URL |
| inviteClarityMeetingNotetaker | Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as a 'meeting' capture on the process |
| deleteClarityCapture | Delete a capture from a clarity process |
| createClarityGuidance | Create a new automation guidance message for a clarity process |
| updateClarityGuidance | Update the automation guidance message for a clarity process |
| getClarityProcessSharing | Get the sharing status for a clarity process |
| updateClarityProcessSharing | Enable or disable sharing for a clarity process |
| sendClarityInterviewInvites | Invite people to record an interview about this Clarity process, and email each of them. To invite people from the organization chart or landscape, first use the Clarity hierarchy people tools to find their names and email addresses,... |
| listClarityInterviewInvites | List a Clarity process's pending and accepted invitations, newest first, with whether each was accepted, whether it was sent an account-free interview link, and whether the invitee has opened that link or submitted an interview.... |
| getClarityProcessInviteLink | Get the active interview invite link for a process. |
| deleteClarityProcessInviteLink | Delete the active interview invite link for a process. |
| getClarityProcessJoinInfo | Get information about a clarity interview invite link (public). |
| acceptClarityProcessJoin | Accept a clarity interview invite link and gain process access. |
| updateClarityLandscapeNode | Rename a process landscape node or update its owner label (team manager or above for team processes; organization admin for areas) |
| acceptClarityLandscapeNode | Accept a proposed area folder into the active process landscape, so it stops being a proposal and becomes part of the real structure (organization admin+). Only area folders can be accepted; a proposed process becomes real through... |
| declineClarityLandscapeNode | Reject a proposed process landscape node while it is still a proposal, removing it and any proposed descendants. Real processes nested underneath survive and move back to Unsorted. Only proposals can be declined — an accepted node is... |
| deleteClarityLandscapeNode | Soft-delete a tree node and its descendants. Organization admins may delete any subtree; team managers may delete a childless process node owned by their team. The targeted node's linked clarity process and captures are deleted, while... |
| setClarityLandscapeNodePlacement | Move a process landscape node (team builder or above for team processes; team manager or above for team proposals; organization admin for areas) |
| reorderClarityLandscapeAreas | Reorder a sibling group of the organization's process landscape area folders left-to-right — the top-level areas by default, or the folder children of parentId (organization admin+). This changes display order only; use... |
| assignClarityLandscapeNodeTeam | Set the owning team of a process in the process landscape (organization admin+). On a proposed process this accepts the proposal and creates the real process for that team; on an existing process it moves the process, its captures and... |
| createClarityProcessNode | File an existing Clarity process into an area of the process landscape (team builder or organization admin+). Use this for a process that already exists but sits in Unsorted; use proposeClarityLandscapeProcess to create a brand-new one. |
| proposeClarityLandscapeProcess | Create a manual process in the organization's Process Landscape, either as an unassigned proposal or atomically assigned to an eligible team. |
| batchAddClarityLandscapeNodePeople | Add one or more people to multiple Process Landscape nodes in a bounded batch. Email entries can create invitations; each node-person outcome reports success, conflict, or delivery failure. |
| listClarityLandscapeNodePeople | List the people involved in the process behind one process landscape node. To read the people across the whole landscape in one request, use getClarityHierarchyPeople instead. |
| addClarityLandscapeNodePerson | Add a person involved in the process behind a process landscape node. Name only records a placeholder; supplying an email also gives that person access to the process and emails them an invitation, so only pass an email the user asked... |
| updateClarityLandscapeNodePerson | Change the role a person plays in the process behind a process landscape node (for example "Approver"). Send role: null to clear it. |
| removeClarityLandscapeNodePerson | Remove a person from the process behind a process landscape node, and revoke the process access they were granted when they were added. |
| acceptClarityTeamAssignmentSuggestion | Accept a pending Process Landscape team-assignment suggestion and durably assign the suggested team (manager+). |
| dismissClarityTeamAssignmentSuggestion | Dismiss a pending Process Landscape team-assignment suggestion without changing the node's owner (manager+). |
| getClarityProcess | Get the v2 read model for a clarity process: the process row (with operational fields like generation_error, generation_progress, generation_started_at, generation_last_activity_at, custom_prompt), its captures, and the lightweight... |
| getClarityCapture | Get a single Clarity v2 capture including full transcript and video transcript. Use this when the process was loaded with captures=lite, or when only one capture's transcript is needed. |
| postprocessClaritySnapshot | Re-run postprocessing agents on an existing v2 clarity snapshot. Targets either the current-process snapshot or the automation proposal snapshot, identified by id in the body. Flips the process status to `generating` and returns 202... |
| listClarityStepFrames | Return one representative screenshare frame for each current-process step. Explicit frame evidence wins. Otherwise, a timestamped screenshare transcript source selects the closest persisted frame at or after that timestamp, with the... |
| buildClarityAutomation | Hand an automation proposal for a v2 clarity process off to the workflow-builder pipeline. Builds from `transformation_proposal_id` when supplied, otherwise from the process's live proposal. The proposal id is the durable idempotency... |
| listClarityExtraCaptureRequests | List active extra-capture requests for a given automation proposal of a Clarity v2 process. The caller is expected to know the proposal id from the V2 read model and skip the call when no proposal exists yet. |
| assignClarityExtraCaptureRequest | Assign (or unassign, with `user_id: null`) a team member to fulfil an extra-capture request. Restricted to Lead Builders and above. |
| createClarityInviteLink | Create or regenerate a process-scoped Clarity interview invite link. Only the process creator or team managers can create invite links; creating a new link invalidates any prior active link for the process. |
| createClarityArtifactImportUploadUrl | Create a signed upload URL for importing a Miro export into a Clarity v2 process. Supports SVG, XML, PNG, and JPEG exports. The caller must upload the file to the returned URL, then complete the import. |
| completeClarityArtifactImport | Complete a Miro artifact import after uploading to the signed URL. The uploaded bytes are validated before the import becomes a usable Clarity capture. |
| listClarityArtifactChatConversations | List the current user's recent non-deleted artifact-chat conversations for a Clarity v2 process and snapshot kind. |
| getClarityArtifactChatMessages | Load the latest artifact-chat messages for one active conversation, returned oldest-first. |
| deleteClarityArtifactChatConversation | Soft-delete an open or running artifact-chat conversation for the current user. |
| stopClarityArtifactChatConversation | Stop an in-flight artifact-chat turn. Flips the conversation back to `open` first so the interrupted run's late webhooks are dropped as stale, then best-effort interrupts the cc-server execution. |
| upgradeClarityProcess | Move a v1 clarity process into v2. Rows with generated analysis are reset in place and regenerated; rows without analysis migrate in place when not generating. |
| listClarityProcessSnapshots | List lightweight Clarity v2 process snapshots for one kind. |
| getClarityProcessSnapshot | Fetch the full payload for a Clarity v2 process snapshot of either kind. |
| saveClarityProcessSnapshot | Save user edits as the live Clarity v2 snapshot for the selected kind. |
| promoteClarityProcessSnapshot | Promote a draft or historic Clarity v2 snapshot to live for its kind. |
| revertClarityProcessSnapshot | Archive a Clarity v2 snapshot of either kind. If the live row is archived, the repository auto-promotes the latest historic row of the same kind. |
| generateClarityProcessSnapshot | Trigger a snapshot generation pipeline for a v2 clarity process, selected by kind. `current_process` runs the generateCurrentProcess pipeline (body fields are proposal-only and rejected); `transformation_proposal` runs the generate or... |
| stopClarityProcessSnapshot | Stop an in-flight snapshot generation for the selected kind. Reads the sandbox id from the process row, kills the sandbox, flips the process back to `review`, and clears the sandbox marker so any late webhook from the killed run is... |
| bulkGenerateClarityProcessSnapshots | Start snapshot generation for many v2 clarity processes in the current team. Starts at most a share of the free sandbox capacity per call; the rest come back in `deferred` and should be sent again once some of the started runs finish.... |
| createWorkspace | Set up the user's Duvo workspace, or return the one they already have (`created: false`, nothing created). Call it first when the user has no workspace: other tools fail with 'User has no current team' until one exists. A new workspace... |
| inviteOrgMember | Invite a person to an organization you administer, optionally assigning them to a team in that organization. Requires an organization Admin, Executive, or Owner role. You cannot grant a role higher than your own. |
| listOrgTeams | List teams belonging to an organization you are a member of, including your membership and role in each. |
| listOrgAgents | List every agent across all teams in an organization, with the team it belongs to, the state of its most recent run and the state of its schedules. Intended for external monitoring: it answers 'which agents have gone silent' and 'which... |
| listOrgRuns | List runs across every team in an organization, filtered by status, agent, team, source, evaluation issues and time. Intended for external monitoring: one call covers the whole org instead of one per team. Requires an organization... |
| getOrgInsightsHeadline | Get org-wide headline insight KPIs (run totals, success rate, distinct active agents and users) aggregated across every team in the organization. Requires an organization Admin, Executive, or Owner role. |
| getOrgInsightsMetrics | Get org-level insights metrics (runs, assignments, schedules) broken down per team across the organization. Requires an organization Admin, Executive, or Owner role. |
| getOrgInsightsUsageChart | Get org-level run-volume buckets (scheduled vs on-demand) at day/week/month granularity across the organization. Requires an organization Admin, Executive, or Owner role. |
| createOrgTeam | Create a new team under an organization you administer. Requires an organization Admin, Executive, or Owner role. |
| organizeClarityProcessLandscape | Start an asynchronous organization pass over the organization's unfiled processes, placing them into the Process Landscape where possible (organization admin+). Results appear progressively; started is false when there is nothing to organize. |
| getClarityProcessTree | Fetch the organization's process tree, or the subtree under rootId. Narrow a large organization with `rootId` (one subtree) or `ownerTeamId` (one team's processes) — a whole-organization tree is large enough to be refused by response-size caps |
| getClarityProcessLandscape | Fetch the organization's full process landscape with process summaries, team assignments, and page-level stats |
| getClarityHierarchyPeople | List the people attached to every authorized linked process node in the organization's Process Landscape. Returns a flat list where each person carries `nodeId` and `processId`, plus their role, invite status, and capture count. Narrow... |
| listClarityLandscapeCaptures | List the organization's Process Landscape captures. By default, only captures eligible to seed new process proposals are returned; excluded captures can be included for inspection. |
| generateClarityProcessLandscape | Start a process-landscape generation run for the organization from its eligible Clarity captures (organization executives and owners) |
| createClarityLandscapeNode | Create an area folder in the process tree. An active area (the default) requires organization admin+ or manager+ on a team of the organization; a "proposal" area may be added by any organization member. |
| listClarityProcessLinks | List process-to-process links in the organization's Clarity landscape that are visible within the caller's team access scope. Use `node_id` to find links touching a specific process node. |
| createClarityProcessLink | Create a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams. If the same live source, target, and type already exists, the existing link is returned. |
| updateClarityProcessLink | Update a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams. |
| deleteClarityProcessLink | Delete a process-to-process link from the organization's Clarity landscape when the caller can manage both endpoint teams. |
| setClarityLandscapePriorities | Set or clear heatmap priorities in one batch (team managers for their processes; organization admin+ across the organization) |
| listClarityOrganizationInterviews | List Clarity interviews across an organization |
| getClarityOrganizationInterview | Load a single organization Clarity interview with transcript |
| inviteClarityOrganizationNotetaker | Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as an organization Clarity interview |
| finalizeClarityOrganizationInterview | Manually mark an in-progress organization interview as complete without requiring final media uploads |
| updateClarityOrganizationInterview | Rename an organization landscape Clarity capture |
| deleteClarityOrganizationInterview | Delete an organization-level Clarity interview |
| createClarityOrganizationDocumentUploadUrl | Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, or BPMN document as an organization-level Clarity capture |
| completeClarityOrganizationDocumentUpload | Complete an organization document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation |
| listMyOrganizations | List the organizations the current user belongs to, with their role (organization:member, organization:admin, organization:owner, or organization:executive) and member count in each. Use this to check whether the user has an... |
| getClarityExport | Get a Clarity export run by ID |
| getQueue | Get a queue by ID. |
| listQueueAggregations | List a queue's aggregation definitions. |
| createQueueAggregation | Create an immutable aggregation definition on a queue. |
| evaluateQueueAggregation | Evaluate an aggregation definition against the current data without persisting it. |
| getQueueAggregationResult | Read an aggregation definition's cached result. |
| refreshQueueAggregation | Force a fresh recompute of an aggregation definition. |
| deleteQueueAggregation | Soft-delete an aggregation definition. |
| updateQueue | Update a queue. |
| pauseQueue | Pause a queue. A paused queue starts no new case: runs already in progress finish, and its pending cases stay pending until the queue is resumed. The pause applies immediately, whether or not the team uses automation revisions, and... |
| resumeQueue | Resume a paused queue. Its pending cases start on the next dispatch, within the queue's concurrency limit. Resuming a queue that is not paused changes nothing. Only a builder or team admin, or someone whose case trigger on the queue is... |
| deleteQueue | Delete a queue. Interrupts all associated active runs first and returns the number of deleted cases plus the IDs of runs that were stopped. |
| exportCases | Export a queue's cases, respecting the same status, severity, failure source, approval, priority, label, date-range, json_data field, and free-text filters as the list view. Set awaiting_my_approval to export only the cases holding an... |
| getCase | Get a case by ID. Returns the case, its event history, and every case-approval batch ever created on the case (newest first). |
| updateCase | Edit a case's title and/or its data payload. Provide at least one field. For the payload, send free-form `data` OR a structured `json_data` object, never both. `json_data` is validated against the queue's Case schema and requires the... |
| setCaseJsonDataFields | Set one or more fields of a typed case's structured `json_data` payload in one atomic write, leaving every other field as stored. Prefer this over `PATCH /cases/{case_id}` with a full `json_data` object when changing some fields: the... |
| listCaseRuns | List Runs (agent runs) that have claimed or received handover of a case, newest first. Capped at 50 ownership events. |
| listCaseRunRecentMessages | Return the latest qualifying messages (assistant text + tool calls) for a Run on a case, newest last. Used to populate the live body of an active Run card in the case Activity timeline. |
| deleteCase | Delete a case. Interrupts any associated active runs first. |
| bulkReprocessCases | Re-process multiple cases on a chosen agent. Any active runs on the selected cases are interrupted first; the cases are then reset to pending and assigned to the chosen agent for the next dispatcher tick. The chosen agent must already... |
| bulkUpdateCaseStatus | Update the status of multiple cases to pending, completed, failed, or canceled. Interrupts any active runs and releases their case ownership, but never cancels their human-in-the-loop state — pending requests and open approval batches... |
| bulkUpdateCasePriority | Set the priority of multiple cases. Priority only affects the order pending cases are picked up in: due postponed cases are handled first, then higher priority. It never interrupts runs or changes case status. Set `none` to clear... |
| listCaseAttachments | List the files attached to a case, oldest first. Includes attachments whose upload failed, so a missing source document is visible rather than silent. |
| createCaseAttachmentUploadUrl | Issue a signed URL for uploading a file to a case. The client must PUT the bytes to the returned URL with the returned Content-Type, then call the finalize endpoint so the attachment becomes visible on the case. |
| finalizeCaseAttachment | Confirm an uploaded case attachment against storage. Answers with the attachment in its settled state — `ready` when the bytes are present, `failed` (with a reason) when the upload never completed. |
| getCaseAttachmentDownloadUrl | Mint a short-lived signed URL for one case attachment. `disposition=inline` serves the file for the in-app viewer; `attachment` forces a download. |
| deleteCaseAttachment | Remove a file from a case. The row is soft-deleted; deletion of the stored object is attempted best-effort. |
| assignCaseLabels | Assign one or more labels to a case. Creates the labels on the queue if they don't already exist. |
| listCaseLabels | List all labels assigned to a case. |
| listQueueLabels | List every label defined on a queue along with the count of cases each label is assigned to. |
| unlinkCaseLabels | Remove the given labels from a case. |
| createQueueLabel | Create a label on a queue without assigning it to a case. |
| deleteQueueLabel | Delete a label from a queue. Cascade-deletes all assignments of this label on existing cases. |
| updateQueueLabel | Update a label's key, value, or color. Renaming key/value affects every case assigned to this label. |
| listQueueAgents | List agents bound to a queue as producers (agents that push cases into the queue) or consumers (agents triggered by cases in the queue). |
| getCaseQueueEvalRubrics | List a queue's active case-level evaluation rubrics — the Pass/Fail questions a whole case is judged against at settlement. Shows the queue's current version's set (auto-generated from the connected Assignments' AOPs, plus any... |
| createCaseQueueEvalRubric | Add one case-level evaluation rubric to a queue's current rubric set. Case-level rubrics judge the whole case (across every Run that touched it) as a Pass/Fail question at settlement. The rubric is added to the queue's current version... |
| replaceCaseQueueEvalRubrics | Replace the entire case-level evaluation rubric set on a queue's current version (1 to N rubrics, N being 12 by default and 25 on teams with the newer rubric generator enabled). Existing rubrics are removed and the supplied list becomes... |
| updateCaseQueueEvalRubric | Edit a single case-level evaluation rubric's title and/or description. The edit produces a NEW rubric (with a new id and slug) so previously judged cases stay attributed to the original criterion; the response contains the new rubric. |
| deleteCaseQueueEvalRubric | Remove a single case-level evaluation rubric. Cases settled after this are no longer judged against it; already-judged cases keep their original verdicts. Removing the queue's last remaining rubric is refused with 409 — whole-case... |
| listCases | List cases in a queue. Supports status, date-range, free-text, and json_data field filters via query params. Set count_only=true to skip Case row selection and transformation. The normal response shape is returned with cases: [] and the... |
| searchCases | Search cases in a queue with rich filters (multi-status, date ranges, label-based filters, and field-value filters over a typed queue's json_data). Use this when the simple query-string filters on GET /v2/queues/:queue_id/cases aren't... |
| createCases | Create one or more cases in a queue. Provide either a single `case` object or a `cases` array (1-100); providing both returns 400. Each case takes a title (max 500 chars), optional labels that will be assigned to the case on creation... |
| getRun | Get information about an agent run. Can be polled to check status. |
| postRunMessage | Post a message to an agent run. This will persist the message and resume the agent execution if the run is completed or interrupted and has no pending human request. A run whose workspace data retention deleted answers 410 with code... |
| listRunMessages | Get paginated messages for an agent run. Messages are returned in chronological order. |
| respondToHumanRequest | Respond to a human-in-the-loop request. Use 'approved' (true/false) for approval-type requests, or 'answers' ({question: answer}) for question-type requests. Only works when the run is in 'waiting' status. |
| stopRun | Stop an agent run. No-op if the run is not currently running. |
| listMyTeams | List teams the authenticated caller can act on. Team-scoped API keys see only the key's team; managed Ask Duvo keys stay within their origin boundary; human user-scoped API keys and OAuth callers see every team they're a member of. |
| updateAgentFolder | Rename an agent folder or move it to a new parent. |
| deleteAgentFolder | Delete an agent folder. If the folder contains assignments or subfolders, pass `force=true` to delete it and move the contained assignments to the root level. |
| getConnection | Get one of your connections by ID. |
| getConnectionCredentials | Get the header keys configured for a connection. Sensitive values (api keys, tokens, passwords) are returned as empty strings — the response only reveals which credential fields are set, never their values. |
| updateConnection | Update an existing connection. For sensitive header values, sending an empty string keeps the existing value; send a new value to overwrite. Toggling `shared` moves the connection between personal and team-shared. |
| deleteConnection | Delete a connection (disconnects the user's connection and removes any triggers bound to it). |
| deleteCustomIntegration | Delete a custom integration type (team-level catalog entry) and cascade-remove related connections. Requires manager-or-above role. |
| getSecret | Get an env-var secret by id. Returns metadata and env var keys; secret values are never exposed. |
| updateSecret | Update an env-var secret. Send `values` to replace all entries, or any of `rename_keys`, `remove_keys`, `add_values` for a non-destructive patch. Editing a team-shared secret or toggling sharing requires lead builder role. |
| deleteSecret | Soft-delete an env-var secret. Deleting a team-shared secret requires lead builder role. |
| listRevisionSecrets | List env-var secrets attached to a specific revision (build) of an assignment. Returns metadata and env-var keys only — secret values are never exposed. |
| attachRevisionSecret | Attach an env-var secret to a revision so its keys are injected into Runs spawned from that revision. Personal secrets can only be attached by their owner; team-shared secrets require builder permissions. |
| detachRevisionSecret | Detach an env-var secret from a revision. Personal secrets can only be detached by their owner; team-shared secrets require builder permissions. |
| listRevisionLogins | List logins attached to a specific revision (build) of an assignment. Returns metadata only — passwords and OTP secrets are never exposed. |
| attachRevisionLogin | Attach a login to a revision so the agent can use it during Runs spawned from that revision. Personal logins can only be attached by their owner; team-shared logins require builder permissions. |
| detachRevisionLogin | Detach a login from a revision. Personal logins can only be detached by their owner; team-shared logins require builder permissions. |
| getNotification | Get a single notification by id for the authenticated user. Requires the Notification Center feature; returns 404 when it is not enabled for the team, or when automation_id is set and the notification is not about that automation. |
| markNotificationRead | Mark a notification as read for the authenticated user. Idempotent — calling it again on an already-read notification still returns success. Pass `openedFrom` to record which channel the reader came through (`in_app` when they were... |
| dismissNotification | Dismiss an important notification for the authenticated user. A row pinned to their Important section is unpinned and the card stays, because the connection is still broken; a row that is not pinned for them — one they cannot reconnect... |
| listClarityProcessLabels | List process tags available in an organization. |
| createClarityProcessLabel | Create process tags for an organization. |
| updateClarityProcessLabel | Update process tags for an organization. |
| deleteClarityProcessLabel | Delete process tags from an organization. |
| listClarityProcessAssignedLabels | List process tags on a process. |
| assignClarityProcessLabels | Assign process tags to a process. |
| unlinkClarityProcessLabels | Remove process tags from a process. |
| listAvailableClarityProcessLabels | List process tags available for a process. |
| listAgents | List agents for your team. Pass `config=light` to leave each agent's revision config out of the page and get its sizes instead; read the AOP with getRevisionBody. |
| createAgent | Create a new agent. Optionally include a build configuration to create the first build in the same request. On a team that versions its automations, an agent created inside an automation joins that automation's draft revision: its first... |
| listAutomations | List the team's automations, each with its live agent and queue counts. An automation is the workspace container an agent or queue belongs to on a team that has moved to Automations — its id is what `POST /queues` and `POST /agents`... |
| createAutomation | Create a new automation. Its first agent is created alongside it so the caller lands on something editable; `first_agent` seeds that agent's name, configuration, and connections instead of the defaults. On a team on revision semantics... |
| setUpModule | Set up a Duvo Module (a ready-made solution such as AP Invoice Intake & Routing or Freight Audit) as a new Automation on the team, the same as pressing Set up on the Module in the web app. Creates the Module's Agents, code steps,... |
| listAgentFolders | List all agent folders for the authenticated team. |
| createAgentFolder | Create a new agent folder. |
| moveAgentsToFolder | Move one or more agents (assignments) into a folder, or to the root level. |
| moveAutomationsToFolder | Move one or more automations into an agent folder, or to the root level. |
| listQueues | List queues for your team. |
| createQueue | Create a new queue. |
| getBatchQueueStats | Get case status counts for many Queues in ONE call. Use this after listQueues whenever you need per-Queue counts — cases waiting on a human, needing review, pending, failed — instead of calling listCases or searchCases once per Queue.... |
| listRuns | List runs for the current team. Supports filtering by agent, user, queue, status, etc. Messages, evaluation data, and queue metadata are included where available. Set count_only=true to skip Run row selection and enrichment. The normal... |
| startRun | Start a new agent run. Returns immediately with run info - does not wait for completion. |
| listSkills | List all skills for the current team, including system skills. |
| createSkill | Create or update a skill from a JSON body. The server constructs SKILL.md from the provided fields and stores it. If a skill with the same name already exists in the team, it is updated. |
| listClarityProcesses | List Clarity processes for the current team, most recently updated first. Returns lightweight metadata (capture counts, contributors, status) suitable for building a picker; the per-process read model is available via `GET... |
| listClarityProcessSummaries | Cross-process portfolio digest for every completed Clarity process on the team: per-process summary, SWOT, projected impact, and a step skeleton (role, system, and flow edges) — without step prose or source excerpts. Paginated (default... |
| createClarityProcess | Create a new Clarity v2 process for the current team (Builder+). Optional `name` defaults server-side when omitted. Response uses camelCase `createdAt` to match existing FE clients. |
| listFiles | List files for the current team. |
| createFileUploadUrl | Generate a signed URL for uploading a file directly to GCS. |
| renameFile | Rename a file in team storage. |
| deleteFile | Delete a file from team storage. |
| getFileDownloadUrl | Generate a signed download URL for a file. |
| getFileContent | Get the content of a text file. |
| updateFileContent | Update the content of a text file. |
| listIntegrations | List the team's integration catalog: built-in integration types plus the custom connection types this team owns or has been granted by another team in its organization. OAuth authorization flows are browser-based and cannot be performed... |
| createCustomIntegration | Create a custom integration type (team-level catalog entry) that users can then connect as user-provided MCP connections. Requires manager-or-above role. |
| listConnections | List the authenticated user's connections (connected integration instances) for the current team. Includes team-shared instances visible to the caller, and instances another team has granted to this one, when the org-level Connections... |
| createConnection | Create a new user-provided connection (custom MCP server) for the current team. A custom MCP server is registered first with `POST /v2/teams/:team_id/integrations/custom`, and its id is passed as `custom_integration_id`; a custom MCP... |
| probeMcpServer | Probe an MCP server URL and list the tools it exposes. Useful as a dry-run before creating a connection — verifies the URL is reachable, that authentication headers (if any) are correct, and surfaces the tool catalog. Performs no... |
| listSecrets | List env-var secrets the caller can reach in this team — team-shared (user_id IS NULL), the caller's own personal entries, and secrets another team in the organization has granted to this team. Returns metadata and env-var keys only;... |
| createSecret | Create an env-var secret. Personal by default; pass `shared: true` to create a team-shared secret (requires lead builder role). |
| createTeamInvite | Invite one person to a team. Pass `processId` to invite them to a specific Clarity process instead of the whole team (that requires the `team:clarity-member` role). Creating the invitation does NOT email anyone — call... |
| deleteTeamInvite | Revoke a pending invitation so its link and email can no longer be used. Accepts either a team invitation (requires Superadmin or above on the invitation's team) or a Clarity process invitation (requires the process creator or a team... |
| sendTeamInviteEmail | Email an invitation to its recipient. Use this to deliver an invitation created by createTeamInvite (which never sends mail on its own), or to resend one the recipient never received. The accept link is always built from the... |
| bulkCreateTeamInvites | Invite several people to a team in one call, emailing each invitation immediately. Returns per-batch counts: `succeeded` were invited, `skipped` were already on the team, already had a pending invitation, or were a duplicate of an... |
| updateTeamInvite | Change the role on a pending team invitation. Only pending invitations can be updated — one already accepted or declined is rejected. Requires the Manager role or above on the invitation's own team. |
| getTeamInviteLink | Get the team's shareable invite link — the one URL anyone can use to join the team, as opposed to a per-person invitation. Returns `hasLink: false` when no link has been created. Requires the Manager role or above. |
| createTeamInviteLink | Create or regenerate the team's shareable invite link — the one URL anyone can use to join the team. Regenerating invalidates the previous link, so anyone still holding the old URL can no longer join. Requires the Manager role or above. |
| deleteTeamInviteLink | Delete the team's shareable invite link so the URL stops working. Per-person invitations are unaffected. Requires the Manager role or above. |
| listNotifications | List notifications for the authenticated user's current team, most recent first. Filter with type, unread, severity or minSeverity (mutually exclusive), important, agentRunId, or processId; paginate with limit/cursor. Pass batchId to... |
| getNotificationFeed | List the notification feed for the authenticated user's current team, most recent activity first. Each item is either an individual notification or a notification batch (a per-agent group of job_issue/eval_issue/job_done/schedule_issue... |
| getNotificationBatch | Get a single notification batch by id for the authenticated user, with per-type live-member counts, unread count, and worst severity. Serves cold deep links and sidebar retention for batches the caller can no longer see in the feed.... |
| markNotificationBatchRead | Mark every unread live member of a notification batch as read for the authenticated user. Pass `types` to narrow the mark-read to those member types, and `severity` (exact) or `minSeverity` (threshold, mutually exclusive with... |
| getUnreadNotificationCount | Get the unread notification count for the authenticated user's current team, or only for one automation's notifications when automation_id is set. Each notification batch with unread members counts as 1, regardless of its member count.... |
| getNotificationCounts | Per-type notification counts for the authenticated user's current team. Narrow with `unread`, `important`, and with either `severity` (counts only that exact severity) or `minSeverity` (counts that urgency and above) — the two are... |
| markAllNotificationsRead | Mark all notifications as read for the authenticated user's current team. Returns the count of notifications that were updated. Requires the Notification Center feature; returns 404 when it is not enabled for the team. |
| deleteReadNotifications | Soft-delete all read notifications for the authenticated user's current team. Returns the count of notifications that were deleted. Destructive — only call on explicit user request. Requires the Notification Center feature; returns 404... |
| deleteAllNotifications | Soft-delete all notifications for the authenticated user's current team, read or unread. Returns the count of notifications that were deleted. Destructive — only call on explicit user request, never bulk-delete unprompted. Requires the... |
| listTeamMembers | List members of a team. The authenticated session or API key must be scoped to the requested team. |
| updateTeamMemberRole | Update an existing team member's role. Requires the Manager role or above; only an Owner may grant or remove the Owner role, and the last remaining Owner cannot be demoted. A member whose Owner role is inherited from the organization... |
| removeTeamMember | Remove a member from a team. Removing another member requires the Superadmin role or above; any member may remove themselves (leaving the team). The last remaining Owner cannot be removed, and a member whose Owner role is inherited from... |
| listTeamInvites | List a team's pending invitations — everyone invited who has not yet accepted or declined. Pass `processId` to list the pending invitations for a single Clarity process instead. |
| listCredentials | List browser-login credentials visible to the caller for the current team — team-shared (user_id IS NULL) plus the caller's own personal logins. Optionally filter by `domain`. Passwords and OTP secrets are never returned; only metadata... |
| createCredential | Create a login. At least one of `password` or `otp_secret` must be provided. Personal by default; pass `shared: true` to create a team-shared login (requires lead builder role). |
| getCredential | Get a login by id. Returns the encrypted password/otp_secret blobs — only the owner or team members can access it. |
| updateCredential | Update a login by id. At least one of password or otp_secret must remain set after the update. Editing a team-shared login or toggling sharing requires lead builder role. |
| deleteCredential | Delete a login by id. Deleting a team-shared login requires lead builder role. |
| listActiveClarityExports | List active (queued or running) Clarity export jobs for the current user |
| startClarityExport | Start a Clarity → SAP Signavio export job |
| listClarityFolders | List the team's process folders with process and suggestion counts |
| createClarityFolder | Create a process folder |
| updateClarityFolder | Rename a process folder. Renaming a landscape-linked folder permanently stops landscape name-sync. |
| deleteClarityFolder | Delete a process folder. Contained processes fall back to Unfiled. |
| reorderClarityFolders | Reorder the team's process folders to match the given id order. The payload must name every folder exactly once. |
| setupClarityFoldersFromLandscape | Create one linked folder per landscape group node containing this team's processes. Idempotent: groups that already have a linked folder are skipped. |
| moveClarityProcessesToFolder | Move processes into a folder (or back to Unfiled) |
| fileSuggestedClarityProcesses | File every unfiled process the viewer can see into its suggested folder |
| listClarityTeamInterviews | List team-level Clarity interviews |
| deleteClarityTeamInterview | Delete a team-level Clarity interview |
| createClarityTeamDocumentUploadUrl | Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, or BPMN document as a team-level Clarity capture |
| completeClarityTeamDocumentUpload | Complete a team document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation |
| getClarityTeamSettings | Get Clarity team settings |
| updateClarityTeamSettings | Update Clarity team settings |
| getClarityPortfolioIntelligence | Get portfolio intelligence for the current team |
| generateClarityPortfolioIntelligence | Generate portfolio intelligence from all completed clarity processes. Returns 202 Accepted immediately and processes in background. |
| movePulseDashboard | Move a Pulse dashboard from the team in the URL to another team, keeping only its latest revision (chat history and older revisions are deleted). The caller must be a Manager or above on both teams. Pass dryRun=true to preview which... |
Get alerted when this changes.
Email the moment io.github.duvoai/duvo drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.duvoai/duvo)
Maintain this server? Add the badge to your README. It links your users to this live status page.