Duvo MCP
Server Details
Governed retail, FMCG, and CPG operational tools: runs, cases, approvals, audit-ready execution.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 393 tools
Hundreds of tools with near-identical purpose clusters make selection error-prone: completeClarityDocumentUpload / completeClarityTeamDocumentUpload / completeClarityOrganizationDocumentUpload / completeClarityImageUpload / completeClarityVideoUpload, plus the matching create*UploadUrl families, are hard to distinguish without reading long descriptions. Notification tools (listNotifications, getNotificationFeed, getNotificationCounts, getUnreadNotificationCount, mark*/dismiss) and clarity landscape tools (createClarityLandscapeNode, createClarityProcessNode, proposeClarityLandscapeProcess, acceptClarityLandscapeNode) overlap heavily. Long descriptions help but the set as a whole is ambiguous at scale.
Almost all tools follow a camelCase verb_noun pattern (listAgents, createQueue, updateCase, deleteSchedule, promoteRevision). A few read as noun/verb hybrids or domain suffixes (checkMcpOAuth, probeMcpServer, fileSuggestedClarityProcesses, setupClarityFoldersFromLandscape) but stay interpretable. The convention is broadly uniform despite the size.
393 tools is an extreme mismatch for a single MCP surface; no coherent toolset of this size can be navigated reliably by an agent. The count reflects many entire product areas (Clarity, Pulse, automations, revisions, skills, notifications, org admin, files, sandboxes) crammed into one server rather than a scoped set.
Coverage across the Duvo platform is broad — CRUD exists for agents, queues, cases, revisions, automations, clarity processes, pulse dashboards, skills, members and notifications — so few obvious dead ends in the main lifecycles. However the domain is so sprawling that the surface is effectively several servers stitched together, making it hard to claim it is complete for any single coherent purpose.
Available Tools
393 toolsacceptClarityLandscapeNodeAccept Clarity Landscape NodeAInspect
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 assignClarityLandscapeNodeTeam instead. Re-accepting an already-active area is a no-op.
Inputs: orgId (required), nodeId (required).
acceptClarityProcessJoinAccept Clarity Process JoinBInspect
Accept a clarity interview invite link and gain process access.
Inputs: token (required).
acceptClarityTeamAssignmentSuggestionAccept Clarity Team Assignment SuggestionAInspect
Accept a pending Process Landscape team-assignment suggestion and durably assign the suggested team (manager+).
Inputs: nodeId (required), suggestionId (required).
acceptRevisionGenerationAccept Revision GenerationAInspect
Accept the reviewed generated configuration and complete the builder run. The saved draft is not activated.
Inputs: build_id (required), builder_run_id (required), expected_started_at (required).
addAutomationAgentAdd Automation AgentAInspect
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 revision it cannot be moved between them at all, because the revisions binding it are immutable. Adding an agent that is already a member succeeds unchanged. When the automation runs as the team, the agent's personal triggers and schedules are turned off, and the add fails with 409 if its live revision sends cases to a queue in an automation that runs as its members. An agent left behind by a deleted automation that ran as the team cannot join one that runs as its members (409). Adding to an automation that runs as the team also fails with 409 when a change in flight holds the rows the add has to update, such as the agent's personal triggers and schedules; that refusal changes nothing and the add can be retried.
Inputs: agent_id (required), automation_id (required).
addAutomationQueueAdd Automation QueueAInspect
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 revision it cannot be moved between them at all, because the revisions binding it are immutable. Adding a queue that is already a member succeeds unchanged. A queue left behind by a deleted automation that ran as the team cannot join one that runs as its members (409 team_to_personal_move), and neither can a queue that an agent in an automation running as the team sends cases to (409 team_to_personal_queue).
Inputs: automation_id (required), case_queue_id (required).
addClarityLandscapeNodePersonAdd Clarity Landscape Node PersonAInspect
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 you to invite.
Inputs: orgId (required), nodeId (required), name, role, +3 more.
addConfigFieldAdd Config FieldAInspect
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 a field added here.
Inputs: type (required), label (required), question (required), automation_id (required), +9 more.
addConfigSectionAdd Config SectionAInspect
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 case, is refused with a 409. A module template reinstall never changes a section added here.
Inputs: name (required), automation_id (required), after_key.
answerPulseDashboardQuestionAnswer Pulse Dashboard QuestionAInspect
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.
Inputs: answers (required), artifactId (required), toolCallId (required).
approveAutomationProposalApprove Automation ProposalAInspect
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 dashboards change, makes the changes once the user agrees there, and finishes the setup. Give the user the conversation's url; they answer Duvo's plan in it. proposal_snapshot_id, when given, must be the live proposal. A build already started is returned with status already_started rather than started twice. Refused with 409 when there is no live proposal, required Policy questions are open, or Ask Duvo isn't available to the team, and with 403 below Builder. With Automation conversion in Ask Duvo on for the team, the conversation runs the same build specification flow as Clarity's Create automation against this automation, and takes its access too: 403 unless the caller created the process, is a Lead Builder or above, or the team's Clarity access is unrestricted. Confirm with the user before calling: approving starts the build.
Inputs: automation_id (required), proposal_snapshot_id.
assignCaseLabelsAssign Case LabelsBInspect
Assign one or more labels to a case. Creates the labels on the queue if they don't already exist.
Inputs: labels (required), case_id (required), queue_id (required).
assignClarityExtraCaptureRequestAssign Clarity Extra Capture RequestADestructiveInspect
Assign (or unassign, with user_id: null) a team member to fulfil an extra-capture request. Restricted to Lead Builders and above.
Inputs: user_id (required), process_id (required), request_id (required), transformation_proposal_id (required).
assignClarityLandscapeNodeTeamAssign Clarity Landscape Node TeamADestructiveIdempotentInspect
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 its brief to another team.
Inputs: orgId (required), nodeId (required), teamId (required), intent.
assignClarityProcessLabelsAssign Clarity Process LabelsCInspect
Assign process tags to a process.
Inputs: id (required), labels, labelIds.
assignPolicyInterviewAssign Policy InterviewAInspect
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 invited_email out to create an unassigned interview slot. This emails a real person: name them, give the exact address and say what the interview covers, and call this only after the user says yes. Use only an address the user gave you. Administrators and above only.
Inputs: automation_id (required), context, invited_email.
assignProcessMemberAssign Process MemberAInspect
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 single sign-on, a request without an SSO sign-in can't add someone who already has an account: it is refused with 403, and that person is added on the automation's People tab. Their team role is never lowered. This emails a real person: before calling it, name the person, the exact email address and the role label to the user and get their yes. Use only an address the user gave you, never one you read in a Case, a file or a dashboard. Take role_key from listProcessRoles. Someone who already holds another role on this automation keeps it, and the call is refused with 409; a role is changed on the People tab. Managers and above only.
Inputs: email (required), role_key (required), automation_id (required).
attachPulseDashboardConnectionAttach Pulse Dashboard ConnectionBInspect
Attach one of your connections (data sources) to a Duvo Pulse dashboard so the agent can use its tools (requires edit access).
Inputs: artifactId (required), connection_id (required).
attachRevisionIntegrationsAttach Revision IntegrationsAInspect
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 integration alone is NOT enough — the slot points at no queue and will fail at runtime until you link at least one queue with replaceRevisionIntegrationQueues. After wiring up, call getRevisionCaseQueueSetup to confirm every case-queue slot has linked_queue_count > 0 before starting work.
Inputs: agent_id (required), build_id (required), integration_ids (required), selected_automation_revision_id.
attachRevisionLoginAttach Revision LoginBInspect
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.
Inputs: agentId (required), buildId (required), exposedCredentialId (required).
attachRevisionSecretAttach Revision SecretAInspect
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.
Inputs: agentId (required), buildId (required), credentialId (required).
authorizeMcpOAuthAuthorize Mcp OAuthAInspect
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 return_url. A new connection to a custom MCP server needs custom_integration_id (register the server first with POST /v2/teams/:team_id/integrations/custom) and is refused with 400 without it; a catalog integration such as NetSuite or Asana takes integration_type instead.
Inputs: name (required), mcp_server_url (required), team_id, return_url, +5 more.
batchAddClarityLandscapeNodePeopleBatch Add Clarity Landscape Node PeopleAInspect
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.
Inputs: orgId (required), people (required), nodeIds (required).
buildClarityAutomationBuild Clarity AutomationAInspect
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 key, so retries return the same run and a different proposal starts a new run. Returns 202 while the LLM run completes asynchronously, or 409 when the resolved proposal is still being written.
Inputs: process_id (required), transformation_proposal_id.
bulkCreateTeamInvitesBulk Create Team InvitesAInspect
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 earlier entry in the same batch, failed could not be emailed (those invitations are rolled back). The accept link is always built from the server-configured app origin.
Inputs: members (required), team_id, frontendUrl.
bulkGenerateClarityProcessSnapshotsBulk Generate Clarity Process SnapshotsAInspect
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. Processes that cannot start (already generating, no usable interviews, not found) come back in skipped with the reason.
Inputs: kind (required), process_ids (required), transformation_aggressiveness.
bulkReprocessCasesBulk Reprocess CasesADestructiveInspect
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 be connected to the queue as a case-queue-consumer (with the trigger enabled or disabled) and not belong to a different automation than the queue. A paused queue refuses with 409; resume it first.
Inputs: queue_id (required), search, filters, agent_id, +2 more.
bulkUpdateCasePriorityBulk Update Case PriorityADestructiveInspect
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 priority back to the default.
Inputs: priority (required), queue_id (required), search, filters, +2 more.
bulkUpdateCaseStatusBulk Update Case StatusADestructiveInspect
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 stay answerable/resolvable from the run view. Settling a case archives the pending requests on every run attached to it, both the runs this call interrupted and any that were already terminal, so they leave the activity inbox instead of outliving the case there. Resetting to pending archives nothing and re-dispatches cases to the queue's trigger consumer. Resetting cases on a paused queue answers 409, because it would interrupt runs the pause lets finish; resume the queue first.
Inputs: status (required), queue_id (required), search, filters, +2 more.
cancelBuilderRunCancel Builder RunBDestructiveInspect
Cancel a running builder run and pause its sandbox
Inputs: status (required), builder_run_id (required).
checkMcpOAuthCheck Mcp OAuthBInspect
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 or /v2/teams/:team_id/connections. Performs no writes.
Inputs: mcp_server_url (required).
completeClarityArtifactImportComplete Clarity Artifact ImportAInspect
Complete a Miro artifact import after uploading to the signed URL. The uploaded bytes are validated before the import becomes a usable Clarity capture.
Inputs: file_name (required), capture_id (required), process_id (required), content_type (required).
completeClarityDocumentUploadComplete Clarity Document UploadAInspect
Complete a document capture after uploading to GCS via signed URL
Inputs: id (required), fileName (required), captureId (required).
completeClarityImageUploadComplete Clarity Image UploadAInspect
Complete an image capture after uploading it to GCS via a signed URL
Inputs: id (required), fileName (required), captureId (required).
completeClarityOrganizationDocumentUploadComplete Clarity Organization Document UploadAInspect
Complete an organization document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation
Inputs: orgId (required), fileName (required), interviewId (required).
completeClarityTeamDocumentUploadComplete Clarity Team Document UploadAInspect
Complete a team document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation
Inputs: fileName (required), interviewId (required), team_id.
completeClarityVideoUploadComplete Clarity Video UploadAInspect
Complete a video capture after uploading to GCS via signed URL
Inputs: id (required), fileName (required), captureId (required).
consumeAgentSuggestionConsume Agent SuggestionBDestructiveInspect
Apply a suggestion: stage its change into the Agent's draft revision, then auto-clear any pending suggestions it makes moot.
Inputs: id (required), revision_id, create_new_draft, selected_automation_revision_id.
createAgentCreate AgentAInspect
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 build is a draft and goes live when the draft is made active.
Inputs: name (required), type, build, team_id, +3 more.
createAgentCaseTriggerCreate Agent Case TriggerAInspect
Create a case trigger for an agent. An agent may have at most one case trigger; this returns 409 if one already exists.
Inputs: enabled (required), agent_id (required), case_queue_id (required), concurrency.
createAgentFolderCreate Agent FolderCInspect
Create a new agent folder.
Inputs: name (required), team_id, parent_folder_id.
createAgentSlackTriggerCreate Slack Channel TriggerAInspect
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 workspace must be installed for the team AND bound to the agent's live build first (see the Slack bound-workspaces endpoint) — otherwise this returns 400.
Inputs: agent_id (required), channel_id (required), match_rule (required), channel_name (required), +4 more.
createAutomationCreate AutomationAInspect
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 the automation holds a single draft revision and no live revision, with the agent's first build bound into that draft, and the first activation makes the draft revision 1; on any other team the automation is a bare container and the build stands on its own.
Inputs: name (required), team_id, first_agent.
createCaseAttachmentUploadUrlCreate Case Attachment Upload UrlAInspect
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.
Inputs: case_id (required), filename (required), queue_id (required), mime_type (required), +1 more.
createCaseQueueEvalRubricCreate Case Queue Eval RubricAInspect
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 (build-set) — the set new cases are judged against; a queue only gets one after its first Agent-processed case settles, so this fails with 409 before then, and once the version holds 12 rubrics by default (25 on teams with the newer rubric generator enabled); the error message states the ceiling.
Inputs: title (required), queue_id (required), description (required).
createCasesCreate CasesAInspect
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 (missing labels are created on the queue), and an optional priority (none, medium, or high; medium/high raise it above the default in the queue, none is the default; priority only affects the order pending cases are picked up in: due postponed cases are handled first, then higher priority). For the case payload, send free-form data OR a structured json_data object, never both, and a single request must be all free-text or all structured. json_data is validated against the queue's Case schema and requires the queue to have one; a schema-guarded queue accepts only json_data, while a queue without the guard also accepts free-text data. A guarded queue that has no schema yet accepts free-text data only when typed Case schemas are off for that queue — the team has them turned off AND the queue is not inside an automation (there is then no way to declare a schema, so the guard cannot apply). A queue inside an automation always has them on, so a guarded one refuses free-text data until its schema is declared.
Inputs: queue_id (required), case, cases.
createClarityArtifactImportUploadUrlCreate Clarity Artifact Import Upload UrlAInspect
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.
Inputs: file_name (required), process_id (required), content_type (required), extra_capture_request_id.
createClarityDocumentUploadUrlCreate Clarity Document Upload UrlBInspect
Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, BPMN, XLSX, or CSV document directly to GCS
Inputs: id (required), fileName (required), contentType (required), extraCaptureRequestId.
createClarityFolderCreate Clarity FolderCInspect
Create a process folder
Inputs: name (required), team_id.
createClarityGuidanceCreate Clarity GuidanceCInspect
Create a new automation guidance message for a clarity process
Inputs: id (required), content (required).
createClarityImageUploadUrlCreate Clarity Image Upload UrlAInspect
Create a signed URL for uploading a PNG, JPEG, WebP, or SVG image directly to GCS
Inputs: id (required), fileName (required), contentType (required), extraCaptureRequestId.
createClarityInviteLinkCreate Clarity Invite LinkADestructiveInspect
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.
Inputs: process_id (required).
createClarityLandscapeNodeCreate Clarity Landscape NodeAInspect
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.
Inputs: name (required), orgId (required), parentId, ownerLabel, +2 more.
createClarityOrganizationDocumentUploadUrlCreate Clarity Organization Document Upload UrlBInspect
Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, or BPMN document as an organization-level Clarity capture
Inputs: orgId (required), fileName (required), contentType (required).
createClarityProcessCreate Clarity ProcessAInspect
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.
Inputs: name, team_id.
createClarityProcessLabelCreate Clarity Process LabelCInspect
Create process tags for an organization.
Inputs: orgId (required), value (required), colorHue.
createClarityProcessLinkCreate Clarity Process LinkAInspect
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.
Inputs: type (required), orgId (required), source_node_id (required), target_node_id (required), +2 more.
createClarityProcessNodeCreate Clarity Process NodeAInspect
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.
Inputs: orgId (required), parentId (required), processId (required).
createClarityTeamDocumentUploadUrlCreate Clarity Team Document Upload UrlAInspect
Create a signed URL for uploading a PDF, Word (.docx), TXT, Markdown, or BPMN document as a team-level Clarity capture
Inputs: fileName (required), contentType (required), team_id.
createClarityVideoUploadUrlCreate Clarity Video Upload UrlAInspect
Create a signed URL for uploading a video file directly to GCS
Inputs: id (required), fileName (required), contentType (required), extraCaptureRequestId.
createConnectionCreate ConnectionAInspect
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 connection without one is refused with 400. OAuth-based integrations (native) require an interactive browser flow — start them with the dedicated OAuth endpoints (/v2/teams/:team_id/connections/oauth/native/:provider/start or /v2/teams/:team_id/connections/oauth/mcp/start) instead of calling this endpoint directly.
Inputs: name (required), provider (required), auth_method (required), type, +4 more.
createCredentialCreate credentialAInspect
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).
Inputs: domain (required), userId (required), shared, team_id, +3 more.
createCustomIntegrationCreate Custom IntegrationAInspect
Create a custom integration type (team-level catalog entry) that users can then connect as user-provided MCP connections. Requires manager-or-above role.
Inputs: name (required), server_url (required), auth_method (required), team_id, +2 more.
createEvalRubricCreate Eval RubricAInspect
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 message states it. Defaults to the Agent's live build; pass build_id to target a specific revision.
Inputs: title (required), agentId (required), description (required), build_id, +1 more.
createFileUploadUrlCreate File Upload UrlBInspect
Generate a signed URL for uploading a file directly to GCS.
Inputs: fileName (required), contentType (required), team_id.
createOrgTeamCreate Org TeamAInspect
Create a new team under an organization you administer. Requires an organization Admin, Executive, or Owner role.
Inputs: name (required), orgId (required).
createPulseDashboardCreate Pulse DashboardAInspect
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 dashboard is private to you unless you set visibility to 'team', which shares it with your whole team straight away — with permission 'view' (teammates see the dashboard) or 'edit' (teammates can also iterate on it).
Inputs: message (required), permission, visibility, connection_ids.
createPulseDashboardAttachmentUploadUrlCreate Pulse Dashboard Attachment Upload UrlAInspect
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 'file', then pass the returned attachment_id in the attachments array of POST /artifacts/{artifactId}/messages. The agent reads the file directly from its sandbox. Files live as long as the dashboard's sandbox (about 12 hours), so upload shortly before sending.
Inputs: filename (required), mime_type (required), artifactId (required), size_bytes (required).
createPulseDashboardCommentCreate Pulse Dashboard CommentAInspect
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.
Inputs: body (required), artifactId (required), element, revision_id.
createPulseDashboardCommentReplyCreate Pulse Dashboard Comment ReplyAInspect
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.
Inputs: body (required), commentId (required), artifactId (required).
createQueueCreate QueueCInspect
Create a new queue.
Inputs: name (required), team_id, folder_id, description, +1 more.
createQueueAggregationCreate Queue AggregationBInspect
Create an immutable aggregation definition on a queue.
Inputs: queue_id (required), definition (required), maximum_stale_age_seconds.
createQueueLabelCreate Queue LabelBInspect
Create a label on a queue without assigning it to a case.
Inputs: value (required), queue_id (required), key, color_hue.
createRevisionCreate RevisionCInspect
Create a new revision for an existing agent.
Inputs: name (required), agent_id (required), config, handover_to, +4 more.
createSandboxCreate SandboxAInspect
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.
Inputs: no named parameters.
createSandboxUploadUrlCreate Sandbox Upload UrlAInspect
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.
Inputs: path (required), sandbox_id (required).
createScheduleCreate ScheduleBInspect
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: one matching a schedule the automation already runs fires at once, and a new one is saved to the automation's draft and fires once the draft is made active (see pending_change).
Inputs: enabled (required), agent_id (required), timezone (required), frequency (required), +5 more.
createSecretCreate SecretAInspect
Create an env-var secret. Personal by default; pass shared: true to create a team-shared secret (requires lead builder role).
Inputs: name (required), values (required), shared, team_id, +1 more.
createSkillCreate SkillAInspect
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.
Inputs: name (required), content (required), description (required), license, +4 more.
createSkillRevisionCreate Skill RevisionAIdempotentInspect
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 previously active revision stays intact and can be re-activated later. A skill has at most one open draft: if one already exists this returns it with created: false.
Inputs: skill_id (required), source_revision_id.
createTeamInviteCreate Team InviteAInspect
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 sendTeamInviteEmail with the returned id to deliver it, or use bulkCreateTeamInvites, which creates and emails in one step.
Inputs: role (required), email (required), team_id, processId, +2 more.
createTeamInviteLinkCreate Team Invite LinkADestructiveInspect
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.
Inputs: team_id, frontendUrl.
createWorkspaceCreate WorkspaceAIdempotentInspect
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 is on the Free plan, with Clarity and Automation. has_clarity_access says whether the team's plan includes Clarity, interviews_remaining counts interviews left on the plan without subtracting people invited but not yet interviewed, and billing_url is where the user upgrades. If the user's organization or email domain is already on Duvo, the call is refused with a link the user must open.
Inputs: no named parameters.
declineClarityLandscapeNodeDecline Clarity Landscape NodeADestructiveInspect
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 removed with deleteClarityLandscapeNode.
Inputs: orgId (required), nodeId (required).
declineRevisionGenerationDecline Revision GenerationADestructiveInspect
Discard generated changes by restoring checkpoint_config and completing the builder run. The saved draft is not activated.
Inputs: build_id (required), builder_run_id (required), expected_started_at (required).
deleteAgentDelete AgentADestructiveIdempotentInspect
Delete an agent and cascade-clean its schedules, case triggers, builder runs, and handover targets. Any active jobs are interrupted and their sandboxes paused.
Inputs: agent_id (required).
deleteAgentCaseTriggerDelete Agent Case TriggerADestructiveIdempotentInspect
Delete a case trigger. Only the trigger creator or a builder/admin can delete it.
Inputs: agent_id (required), trigger_id (required).
deleteAgentFolderDelete Agent FolderADestructiveIdempotentInspect
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.
Inputs: folder_id (required), force.
deleteAgentTriggerDelete Agent TriggerADestructiveIdempotentInspect
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.
Inputs: agentId (required), triggerId (required).
deleteAllNotificationsDelete All NotificationsADestructiveIdempotentInspect
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 Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: team_id.
deleteAutomationDelete AutomationADestructiveIdempotentInspect
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.
Inputs: automation_id (required).
deleteCaseDelete CaseADestructiveIdempotentInspect
Delete a case. Interrupts any associated active runs first.
Inputs: case_id (required).
deleteCaseAttachmentDelete Case AttachmentADestructiveIdempotentInspect
Remove a file from a case. The row is soft-deleted; deletion of the stored object is attempted best-effort.
Inputs: case_id (required), queue_id (required), attachment_id (required).
deleteCaseQueueEvalRubricDelete Case Queue Eval RubricADestructiveIdempotentInspect
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 evaluation regenerates rubrics for an empty set at the next settlement, so the removal would not stay removed.
Inputs: queue_id (required), rubric_id (required).
deleteClarityArtifactChatConversationDelete Clarity Artifact Chat ConversationADestructiveIdempotentInspect
Soft-delete an open or running artifact-chat conversation for the current user.
Inputs: process_id (required), conversation_id (required).
deleteClarityCaptureDelete Clarity CaptureCDestructiveIdempotentInspect
Delete a capture from a clarity process
Inputs: id (required), captureId (required).
deleteClarityFolderDelete Clarity FolderADestructiveIdempotentInspect
Delete a process folder. Contained processes fall back to Unfiled.
Inputs: folderId (required), team_id.
deleteClarityLandscapeNodeDelete Clarity Landscape NodeADestructiveIdempotentInspect
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 nested processes detach to the Unsorted bag.
Inputs: orgId (required), nodeId (required).
deleteClarityOrganizationInterviewDelete Clarity Organization InterviewCDestructiveIdempotentInspect
Delete an organization-level Clarity interview
Inputs: orgId (required), interviewId (required).
deleteClarityProcessDelete Clarity ProcessADestructiveIdempotentInspect
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 from the process keeps running, with its setup answers and people, but is no longer linked to it.
Inputs: id (required).
deleteClarityProcessInviteLinkDelete Clarity Process Invite LinkBDestructiveIdempotentInspect
Delete the active interview invite link for a process.
Inputs: id (required).
deleteClarityProcessLabelDelete Clarity Process LabelBDestructiveIdempotentInspect
Delete process tags from an organization.
Inputs: orgId (required), labelId (required).
deleteClarityProcessLinkDelete Clarity Process LinkADestructiveIdempotentInspect
Delete a process-to-process link from the organization's Clarity landscape when the caller can manage both endpoint teams.
Inputs: orgId (required), process_link_id (required).
deleteClarityTeamInterviewDelete Clarity Team InterviewADestructiveIdempotentInspect
Delete a team-level Clarity interview
Inputs: interviewId (required), team_id.
deleteConnectionDelete ConnectionADestructiveIdempotentInspect
Delete a connection (disconnects the user's connection and removes any triggers bound to it).
Inputs: connection_id (required).
deleteCredentialDelete credential by idADestructiveIdempotentInspect
Delete a login by id. Deleting a team-shared login requires lead builder role.
Inputs: id (required), userId (required), team_id.
deleteCustomIntegrationDelete Custom IntegrationADestructiveIdempotentInspect
Delete a custom integration type (team-level catalog entry) and cascade-remove related connections. Requires manager-or-above role.
Inputs: custom_integration_id (required).
deleteEvalRubricDelete Eval RubricADestructiveIdempotentInspect
Remove a single Agent-specific evaluation rubric. Future Runs on the build are no longer scored against it.
Inputs: agentId (required), rubricId (required), selected_automation_revision_id.
deleteFileDelete FileADestructiveIdempotentInspect
Delete a file from team storage.
Inputs: path (required), team_id.
deletePulseDashboardDelete Pulse DashboardADestructiveIdempotentInspect
Delete a Duvo Pulse dashboard. Only the creator can delete it.
Inputs: artifactId (required).
deletePulseDashboardCommentDelete Pulse Dashboard CommentADestructiveIdempotentInspect
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.
Inputs: commentId (required), artifactId (required).
deleteQueueDelete QueueADestructiveIdempotentInspect
Delete a queue. Interrupts all associated active runs first and returns the number of deleted cases plus the IDs of runs that were stopped.
Inputs: queue_id (required).
deleteQueueAggregationDelete Queue AggregationADestructiveIdempotentInspect
Soft-delete an aggregation definition.
Inputs: queue_id (required), definition_id (required).
deleteQueueLabelDelete Queue LabelADestructiveIdempotentInspect
Delete a label from a queue. Cascade-deletes all assignments of this label on existing cases.
Inputs: label_id (required), queue_id (required).
deleteReadNotificationsDelete Read NotificationsADestructiveIdempotentInspect
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 when it is not enabled for the team.
Inputs: team_id.
deleteScheduleDelete ScheduleADestructiveIdempotentInspect
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 automation's revisions keep the schedule for anyone else subscribed to it.
Inputs: agent_id (required), schedule_id (required).
deleteSecretDelete SecretBDestructiveIdempotentInspect
Soft-delete an env-var secret. Deleting a team-shared secret requires lead builder role.
Inputs: id (required).
deleteSkillDelete SkillADestructiveIdempotentInspect
Delete a skill for the current team.
Inputs: skill_id (required).
deleteSkillRevisionDelete Skill RevisionADestructiveIdempotentInspect
Delete a draft or historic skill revision and its files. The active revision can't be deleted — activate another revision first.
Inputs: skill_revision_id (required).
deleteSkillRevisionFileDelete Skill Revision FileADestructiveIdempotentInspect
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 revisions are read-only: create a draft from one to edit it.
Inputs: path (required), skill_revision_id (required).
deleteSlackTriggerDelete Slack Channel TriggerADestructiveIdempotentInspect
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.
Inputs: trigger_id (required).
deleteTeamInviteDelete Team InviteADestructiveIdempotentInspect
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 admin). Revoking one side also revokes its linked counterpart when a process invitation created both. An invitation already accepted or declined is refused with 409, including one accepted a moment before, and process access the invitee already holds through an earlier acceptance is kept, so revoking never undoes an acceptance.
Inputs: id (required), team_id.
deleteTeamInviteLinkDelete Team Invite LinkADestructiveIdempotentInspect
Delete the team's shareable invite link so the URL stops working. Per-person invitations are unaffected. Requires the Manager role or above.
Inputs: team_id.
detachPulseDashboardConnectionDetach Pulse Dashboard ConnectionADestructiveIdempotentInspect
Detach a connection (data source) from a Duvo Pulse dashboard (requires edit access).
Inputs: artifactId (required), connectionId (required).
detachRevisionLoginDetach Revision LoginBDestructiveIdempotentInspect
Detach a login from a revision. Personal logins can only be detached by their owner; team-shared logins require builder permissions.
Inputs: agentId (required), buildId (required), exposedCredentialId (required).
detachRevisionSecretDetach Revision SecretADestructiveIdempotentInspect
Detach an env-var secret from a revision. Personal secrets can only be detached by their owner; team-shared secrets require builder permissions.
Inputs: agentId (required), buildId (required), credentialId (required).
dismissClarityTeamAssignmentSuggestionDismiss Clarity Team Assignment SuggestionADestructiveInspect
Dismiss a pending Process Landscape team-assignment suggestion without changing the node's owner (manager+).
Inputs: nodeId (required), suggestionId (required).
dismissNotificationDismiss NotificationADestructiveIdempotentInspect
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 themselves — is removed from their feed instead, matching what the card's Dismiss button does. Only important notifications (currently: connection_broken) can be dismissed. Idempotent. Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: id (required).
downloadSkillDownload SkillARead-onlyIdempotentInspect
Download a custom skill as a ZIP archive. Only custom (team-owned) skills can be downloaded.
Inputs: skill_id (required).
duplicateAgentDuplicate AgentAInspect
Duplicate an existing agent into a new agent named "Copy of ", 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 they created; duplicating an agent somebody else created requires the Lead Builder team role or above.
Inputs: agent_id (required), include_aop, include_queue, include_memory, +4 more.
duplicateAutomationDuplicate AutomationAInspect
Duplicate an automation into a new one named "Copy of ", 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 the agent has it on. The caller's own triggers and schedules are copied switched off, so the copy starts no run until they turn them on; other members' triggers and schedules are not copied. An automation built by hand also gets its Policy: sections, questions, answers, and which agents read them. Cases and run history are not copied. A Module demo, and a Module automation with Policy questions, can't be duplicated.
Inputs: automation_id (required).
duplicateClarityProcessDuplicate Clarity ProcessAInspect
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.
Inputs: id (required).
duplicatePulseDashboardDuplicate Pulse DashboardAInspect
Duplicate a Duvo Pulse dashboard, producing an idle clone of the current rendered dashboard. The conversation history, shares, and connections are not copied.
Inputs: artifactId (required).
evaluateQueueAggregationEvaluate Queue AggregationAInspect
Evaluate an aggregation definition against the current data without persisting it.
Inputs: queue_id (required), definition (required).
exportCasesExport CasesAInspect
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 unanswered approval row assigned to you; like the list view it resolves to the authenticated caller, so a credential with no user behind it is rejected rather than exporting an empty file. format: "json" (default) returns a re-importable JSON payload; format: "csv" returns a text/csv file with the columns id, title, status, priority, labels, created_at, updated_at, completed_at, postponed_to, data.
Inputs: queue_id (required), format, search, filters, +2 more.
exportPulseDashboardHtmlExport Pulse Dashboard HtmlBRead-onlyIdempotentInspect
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.
Inputs: artifactId (required), theme.
fileSuggestedClarityProcessesFile Suggested Clarity ProcessesAInspect
File every unfiled process the viewer can see into its suggested folder
Inputs: team_id.
finalizeCaseAttachmentFinalize Case AttachmentAInspect
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.
Inputs: case_id (required), queue_id (required), attachment_id (required).
finalizeClarityOrganizationInterviewFinalize Clarity Organization InterviewAInspect
Manually mark an in-progress organization interview as complete without requiring final media uploads
Inputs: orgId (required), interviewId (required).
generateAutomationProcessMapGenerate Automation Process MapAInspect
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. Returns 202 at once; the map takes a few minutes and appears on the setup's Current Process step (url). Over a map the team already has, it writes a new version. Refused with 409 while required Policy questions are open, a file or interview is still being transcribed, nothing usable is uploaded, or Duvo is already writing the map or the proposal, and with 403 unless the caller created the process or is a Lead Builder or above. Confirm with the user before calling: say it writes the map from what setup has collected. Next comes generateAutomationProposal.
Inputs: automation_id (required).
generateAutomationProposalGenerate Automation ProposalAInspect
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 the team and where work hands over. Returns 202 at once; the proposal takes a few minutes and appears on the setup's Automation Proposal step (url). Needs the team's own live current process map (call generateAutomationProcessMap first) and no proposal yet; current_process_snapshot_id, when given, must be that live map. Refused with 409 otherwise, or while required Policy questions are open or Duvo is already writing, and with 403 unless the caller created the process or is a Lead Builder or above. Confirm with the user before calling: say that approving the map writes the proposal from it. Next comes approveAutomationProposal.
Inputs: automation_id (required), current_process_snapshot_id.
generateClarityPortfolioIntelligenceGenerate Clarity Portfolio IntelligenceAInspect
Generate portfolio intelligence from all completed clarity processes. Returns 202 Accepted immediately and processes in background.
Inputs: team_id.
generateClarityProcessLandscapeGenerate Clarity Process LandscapeBInspect
Start a process-landscape generation run for the organization from its eligible Clarity captures (organization executives and owners)
Inputs: orgId (required).
generateClarityProcessSnapshotGenerate Clarity Process SnapshotAInspect
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 regenerate proposal pipeline. Returns 202 immediately and finalises asynchronously via the cc-server webhook stream.
Inputs: kind (required), process_id (required), custom_guidance, regenerate_from, +2 more.
generateRevisionGenerate RevisionAInspect
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.
Inputs: prompt (required), build_id (required), run_id, process_id, +6 more.
getAgentGet AgentARead-onlyIdempotentInspect
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.
Inputs: agent_id (required).
getAgentCaseTriggerGet Agent Case TriggerARead-onlyIdempotentInspect
Retrieve a single case trigger by id.
Inputs: agent_id (required), trigger_id (required).
getAgentMemoryFileGet Agent Memory FileARead-onlyIdempotentInspect
Get the contents of a single memory file for an agent.
Inputs: path (required), agent_id (required).
getAgentSuggestionGet Agent SuggestionARead-onlyIdempotentInspect
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.
Inputs: id (required).
getAutomationGet AutomationARead-onlyIdempotentInspect
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.
Inputs: automation_id (required).
getAutomationCurrentGet Automation CurrentARead-onlyIdempotentInspect
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 without revisions is read here. links holds a link to each tab the automation has right now.
Inputs: automation_id (required).
getAutomationCurrentFlowGet Automation Current FlowARead-onlyIdempotentInspect
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.
Inputs: automation_id (required).
getAutomationReadinessGet Automation ReadinessARead-onlyIdempotentInspect
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 Connections, Logins or Secrets one by one. Each of items is { key, label, status: ok | missing | broken, detail, link, link_tab } and covers one of: required Policy questions still open, Connections with no working account pinned or that need reconnecting, Logins and Secrets (present or missing, never their values), Queue slots with no Queue linked, Queues with routing off, no Agent or an Agent that is not live yet, what starts it (a Trigger, a Schedule, or Cases added to a routed Queue), the active revision and a pending draft, and whether it is still a demo. While a Module is being set up and its proposal has not been approved, items covers only its setup: required Policy questions, the current process map (setup:process_map) and the automation proposal (setup:automation_proposal), or, when its setup progress is unavailable, one setup item linked to the setup's Get started page, whose approval builds the automation; Connections, Queues and what starts it are checked again once the approved proposal is being built. Lead with what is missing or broken, each with its own link (named by link_tab); never build a link. Quote counts from summary, including connections_to_fix, rather than counting items. ready is null when the caller can't read the Policy; note then says what to tell the user. A Connection only the caller can see counts for the caller. When links_note is present, give no link to the automation at all. Each link is a path in the Duvo web app; give the user the full URL beside it (url, and urls for links).
Inputs: automation_id (required).
getAutomationTabsGet Automation TabsARead-onlyIdempotentInspect
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.
Inputs: automation_id (required).
getBatchQueueStatsGet Batch Queue StatsARead-onlyIdempotentInspect
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. Results are keyed by Queue ID and include zero counts for Queues with no matching cases; Queue IDs from other teams are silently dropped. For a count on a single Queue with richer filters, listCases with count_only=true is the alternative.
Inputs: queue_ids (required), team_id, created_at_to, created_at_from.
getBuilderRunGet Builder RunBRead-onlyIdempotentInspect
Get the status of a builder run
Inputs: builder_run_id (required).
getCaseGet CaseARead-onlyIdempotentInspect
Get a case by ID. Returns the case, its event history, and every case-approval batch ever created on the case (newest first).
Inputs: case_id (required), include_blockers.
getCaseAttachmentDownloadUrlGet Case Attachment Download UrlARead-onlyIdempotentInspect
Mint a short-lived signed URL for one case attachment. disposition=inline serves the file for the in-app viewer; attachment forces a download.
Inputs: case_id (required), queue_id (required), attachment_id (required), disposition.
getCaseQueueEvalRubricsGet Case Queue Eval RubricsARead-onlyIdempotentInspect
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 manually-authored rubrics).
Inputs: queue_id (required).
getClarityArtifactChatMessagesGet Clarity Artifact Chat MessagesARead-onlyIdempotentInspect
Load the latest artifact-chat messages for one active conversation, returned oldest-first.
Inputs: process_id (required), conversation_id (required).
getClarityCaptureGet Clarity CaptureARead-onlyIdempotentInspect
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.
Inputs: capture_id (required), process_id (required).
getClarityExportGet Clarity ExportCRead-onlyIdempotentInspect
Get a Clarity export run by ID
Inputs: id (required).
getClarityHierarchyPeopleGet Clarity Hierarchy PeopleARead-onlyIdempotentInspect
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 it with rootId (one subtree), ownerTeamId (one owning team), and userId or search (one person) — an unfiltered organization roster is large enough to be refused by response-size caps. To find the processes where one person has not captured yet, filter to that person and read captureCount per row. truncated is true when the node subtree or any single process roster was capped.
Inputs: orgId (required), rootId, search, userId, +1 more.
getClarityOrganizationInterviewGet Clarity Organization InterviewBRead-onlyIdempotentInspect
Load a single organization Clarity interview with transcript
Inputs: orgId (required), interviewId (required).
getClarityPortfolioIntelligenceGet Clarity Portfolio IntelligenceBRead-onlyIdempotentInspect
Get portfolio intelligence for the current team
Inputs: team_id.
getClarityProcessGet Clarity ProcessARead-onlyIdempotentInspect
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 version arrays for both snapshot tabs. The full payload of any specific snapshot is fetched lazily via the unified per-snapshot detail endpoint (GET .../snapshots/:kind/:id); this read model deliberately doesn't carry it so the response stays small.
Inputs: process_id (required), captures.
getClarityProcessInviteLinkGet Clarity Process Invite LinkARead-onlyIdempotentInspect
Get the active interview invite link for a process.
Inputs: id (required).
getClarityProcessJoinInfoGet Clarity Process Join InfoCRead-onlyIdempotentInspect
Get information about a clarity interview invite link (public).
Inputs: token (required).
getClarityProcessLandscapeGet Clarity Process LandscapeBRead-onlyIdempotentInspect
Fetch the organization's full process landscape with process summaries, team assignments, and page-level stats
Inputs: orgId (required), rootId, teamId.
getClarityProcessSharingGet Clarity Process SharingCRead-onlyIdempotentInspect
Get the sharing status for a clarity process
Inputs: id (required).
getClarityProcessSnapshotGet Clarity Process SnapshotBRead-onlyIdempotentInspect
Fetch the full payload for a Clarity v2 process snapshot of either kind.
Inputs: kind (required), process_id (required), snapshot_id (required).
getClarityProcessTreeGet Clarity Process TreeARead-onlyIdempotentInspect
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
Inputs: orgId (required), rootId, ownerTeamId.
getClarityTeamSettingsGet Clarity Team SettingsCRead-onlyIdempotentInspect
Get Clarity team settings
Inputs: team_id.
getConnectionGet ConnectionARead-onlyIdempotentInspect
Get one of your connections by ID.
Inputs: connection_id (required).
getConnectionCredentialsGet Connection CredentialsARead-onlyIdempotentInspect
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.
Inputs: connection_id (required).
getCredentialGet credential by idBRead-onlyIdempotentInspect
Get a login by id. Returns the encrypted password/otp_secret blobs — only the owner or team members can access it.
Inputs: id (required), userId (required), team_id.
getEvalRubricsGet Eval RubricsARead-onlyIdempotentInspect
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.
Inputs: agentId (required), build_id.
getEvalScoresGet Eval ScoresARead-onlyIdempotentInspect
Aggregate evaluation counts and flag distribution for an Assignment's Jobs since the given timestamp.
Inputs: since (required), agentId (required), scope, revision_id.
getFileContentGet File ContentBRead-onlyIdempotentInspect
Get the content of a text file.
Inputs: path (required), team_id.
getFileDownloadUrlGet File Download UrlBRead-onlyIdempotentInspect
Generate a signed download URL for a file.
Inputs: path (required), team_id.
getLegacyClarityProcessGet Legacy Clarity ProcessARead-onlyIdempotentInspect
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 snapshot detail tools.
Inputs: id (required).
getNotificationGet NotificationARead-onlyIdempotentInspect
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.
Inputs: id (required), automation_id.
getNotificationBatchGet Notification BatchARead-onlyIdempotentInspect
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. Counts every live member by default; the optional type/severity/minSeverity filters narrow them to matching members only, exactly as the feed narrows a batch row it returns under the same filters. Requires the Notification Center feature; returns 404 when it is not enabled for the team, the batch does not exist, it belongs to another recipient/team, it is not about the automation named by automation_id, or no live member matches the given filters.
Inputs: id (required), type, agents, team_id, +3 more.
getNotificationCountsGet Notification CountsARead-onlyIdempotentInspect
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 mutually exclusive and a request carrying both is rejected with 400. Pass the same filters the feed is showing, so the counts describe the list the reader would land on. Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: agents, unread, team_id, severity, +3 more.
getNotificationFeedGet Notification FeedARead-onlyIdempotentInspect
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 notifications). Filter with type, unread, and either severity (exact match) or minSeverity (threshold; the two are mutually exclusive); paginate with limit/cursor. Either severity filter also narrows a surfaced batch's counts to its qualifying members, and hides a batch with no qualifying live member. The feed is eventually consistent — a batch's counts can lag a concurrent write by one page fetch. Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: type, limit, agents, cursor, +5 more.
getOrgInsightsHeadlineGet Org Insights HeadlineARead-onlyIdempotentInspect
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.
Inputs: orgId (required), endDate, startDate.
getOrgInsightsMetricsGet Org Insights MetricsARead-onlyIdempotentInspect
Get org-level insights metrics (runs, assignments, schedules) broken down per team across the organization. Requires an organization Admin, Executive, or Owner role.
Inputs: orgId (required), endDate, startDate.
getOrgInsightsUsageChartGet Org Insights Usage ChartARead-onlyIdempotentInspect
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.
Inputs: orgId (required), endDate (required), startDate (required), granularity (required), +1 more.
getProfileGet ProfileARead-onlyIdempotentInspect
Get the profile of the authenticated user (the owner of the API key).
Inputs: no named parameters.
getPulseDashboardGet Pulse DashboardARead-onlyIdempotentInspect
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 /artifacts/{artifactId}/messages.
Inputs: artifactId (required).
getPulseDashboardAttachmentDownloadUrlGet Pulse Dashboard Attachment Download UrlARead-onlyIdempotentInspect
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.
Inputs: artifactId (required), attachmentId (required).
getPulseDashboardHtmlGet Pulse Dashboard HtmlARead-onlyIdempotentInspect
Serve a Duvo Pulse dashboard's rendered HTML document (text/html, not JSON). 404 until the first generation turn has produced HTML.
Inputs: artifactId (required).
getPulseDashboardPdfGet Pulse Dashboard PdfARead-onlyIdempotentInspect
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.
Inputs: artifactId (required), theme.
getPulseDashboardVersionHtmlGet Pulse Dashboard Version HtmlARead-onlyIdempotentInspect
Serve a specific version's rendered HTML document for a Duvo Pulse dashboard (text/html, requires edit access).
Inputs: artifactId (required), revisionId (required).
getQueueAggregationResultGet Queue Aggregation ResultARead-onlyIdempotentInspect
Read an aggregation definition's cached result.
Inputs: queue_id (required), definition_id (required).
getRevisionGet RevisionCRead-onlyIdempotentInspect
Get a revision by ID.
Inputs: agent_id (required), build_id (required).
getRevisionBodyGet Revision BodyARead-onlyIdempotentInspect
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 input_chars and source_chars.
Inputs: section (required), agent_id (required), build_id (required), length, +1 more.
getRevisionCaseQueueSetupGet Revision Case Queue SetupARead-onlyIdempotentInspect
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 migrated team, team-wide otherwise). A slot with linked_queue_count of 0 is attached but points at no queue and will fail at runtime — link a queue with replaceRevisionIntegrationQueues before starting work.
Inputs: agent_id (required), build_id (required).
getRunGet RunARead-onlyIdempotentInspect
Get information about an agent run. Can be polled to check status.
Inputs: run_id (required).
getRunEvaluationGet Run EvaluationARead-onlyIdempotentInspect
Get the latest evaluation analysis for a specific agent run (Run).
Inputs: runId (required), agentId (required).
getSecretGet SecretBRead-onlyIdempotentInspect
Get an env-var secret by id. Returns metadata and env var keys; secret values are never exposed.
Inputs: id (required).
getSkillFileContentGet Skill File ContentBRead-onlyIdempotentInspect
Get the content of a file in a skill.
Inputs: path (required), skill_id (required).
getSkillRevisionFileContentGet Skill Revision File ContentBRead-onlyIdempotentInspect
Get the content of a text file in a skill revision.
Inputs: path (required), skill_revision_id (required).
getTeamGet TeamARead-onlyIdempotentInspect
Get a team by ID. The caller must be scoped to the requested team.
Inputs: team_id.
getTeamInviteLinkGet Team Invite LinkARead-onlyIdempotentInspect
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.
Inputs: team_id, frontendUrl.
getUnreadNotificationCountGet Unread Notification CountARead-onlyIdempotentInspect
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. Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: team_id, automation_id.
hideConfigFieldHide Config FieldADestructiveInspect
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 field; hiding is never refused because of them. A module template reinstall keeps the field hidden.
Inputs: field_id (required), automation_id (required).
inviteClarityMeetingNotetakerInvite Clarity Meeting NotetakerBInspect
Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as a 'meeting' capture on the process
Inputs: id (required), meetingUrl (required), joinAt, extraCaptureRequestId.
inviteClarityOrganizationNotetakerInvite Clarity Organization NotetakerCInspect
Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as an organization Clarity interview
Inputs: orgId (required), meetingUrl (required), title, joinAt, +1 more.
inviteOrgMemberInvite Org MemberAInspect
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.
Inputs: role (required), email (required), orgId (required), teamId, +2 more.
listActiveClarityExportsList Active Clarity ExportsARead-onlyIdempotentInspect
List active (queued or running) Clarity export jobs for the current user
Inputs: team_id.
listAgentCaseTriggersList Agent Case TriggersARead-onlyIdempotentInspect
List the case triggers configured for an agent. Each trigger automatically dispatches the agent to run cases added to a queue.
Inputs: agent_id (required).
listAgentFoldersList Agent FoldersBRead-onlyIdempotentInspect
List all agent folders for the authenticated team.
Inputs: team_id.
listAgentMemoryFilesList Agent Memory FilesBRead-onlyIdempotentInspect
List the memory files stored for an agent.
Inputs: agent_id (required).
listAgentRevisionsList Agent RevisionsARead-onlyIdempotentInspect
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.
Inputs: agent_id (required), limit, config, offset, +1 more.
listAgentsList AgentsARead-onlyIdempotentInspect
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.
Inputs: limit, config, offset, team_id, +2 more.
listAgentSchedulesList Agent SchedulesARead-onlyIdempotentInspect
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 /agents/{agent_id}/schedules/all.
Inputs: agent_id (required).
listAgentSlackBoundWorkspacesList Slack Workspaces Bound To An AgentARead-onlyIdempotentInspect
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.
Inputs: agent_id (required), build_id (required).
listAgentSlackTriggersList Slack Channel TriggersARead-onlyIdempotentInspect
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.
Inputs: agent_id (required).
listAgentSuggestionsList Agent SuggestionsARead-onlyIdempotentInspect
List an Agent's suggestions. status=pending is the inbox; status=history is consumed/dismissed/auto-cleared. Reads lazily auto-clear stale pending items.
Inputs: agent_id (required), limit, offset, status.
listAgentTriggersList Agent TriggersARead-onlyIdempotentInspect
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).
Inputs: agentId (required).
listAgentTriggerTypesList Agent Trigger TypesARead-onlyIdempotentInspect
List the trigger types available for an agent, grouped by integration. Use the returned integration_slug and trigger_type values when creating a trigger.
Inputs: agentId (required).
listAllAgentSchedulesList All Agent SchedulesARead-onlyIdempotentInspect
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.
Inputs: agent_id (required).
listAutomationsList AutomationsARead-onlyIdempotentInspect
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 need as automation_id. Its process_node_id is the process whose attributes (Severity, Cost and the like) listProcessAttributeValues reads, and while process attributes are enabled process_attributes carries the values it holds that the caller may see.
Inputs: limit, offset, team_id.
listAvailableClarityProcessLabelsList Available Clarity Process LabelsCRead-onlyIdempotentInspect
List process tags available for a process.
Inputs: id (required), limit, offset, search.
listCaseAttachmentsList Case AttachmentsARead-onlyIdempotentInspect
List the files attached to a case, oldest first. Includes attachments whose upload failed, so a missing source document is visible rather than silent.
Inputs: case_id (required), queue_id (required).
listCaseLabelsList Case LabelsARead-onlyIdempotentInspect
List all labels assigned to a case.
Inputs: case_id (required), queue_id (required), limit, offset.
listCaseRunRecentMessagesList Case Run Recent MessagesARead-onlyIdempotentInspect
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.
Inputs: run_id (required), case_id (required), limit.
listCaseRunsList Case RunsARead-onlyIdempotentInspect
List Runs (agent runs) that have claimed or received handover of a case, newest first. Capped at 50 ownership events.
Inputs: case_id (required).
listCasesList CasesARead-onlyIdempotentInspect
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 matching total. For label filters, use POST /v2/queues/:queue_id/cases/search.
Inputs: queue_id (required), field, limit, offset, +13 more.
listClarityArtifactChatConversationsList Clarity Artifact Chat ConversationsARead-onlyIdempotentInspect
List the current user's recent non-deleted artifact-chat conversations for a Clarity v2 process and snapshot kind.
Inputs: process_id (required), snapshot_kind (required).
listClarityExtraCaptureRequestsList Clarity Extra Capture RequestsARead-onlyIdempotentInspect
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.
Inputs: process_id (required), transformation_proposal_id (required), limit, offset.
listClarityFoldersList Clarity FoldersBRead-onlyIdempotentInspect
List the team's process folders with process and suggestion counts
Inputs: team_id.
listClarityInterviewInvitesList Clarity Interview InvitesARead-onlyIdempotentInspect
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. Paginate with limit and offset; total is the number of invitations. Revoke a pending invitation by passing its id to deleteTeamInvite.
Inputs: id (required), limit, offset.
listClarityLandscapeCapturesList Clarity Landscape CapturesARead-onlyIdempotentInspect
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.
Inputs: orgId (required), limit, include_excluded, includeTranscripts.
listClarityLandscapeNodePeopleList Clarity Landscape Node PeopleARead-onlyIdempotentInspect
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.
Inputs: orgId (required), nodeId (required), teamId.
listClarityOrganizationInterviewsList Clarity Organization InterviewsBRead-onlyIdempotentInspect
List Clarity interviews across an organization
Inputs: orgId (required), limit, scope, offset.
listClarityProcessAssignedLabelsList Clarity Process Assigned LabelsARead-onlyIdempotentInspect
List process tags on a process.
Inputs: id (required).
listClarityProcessesList Clarity ProcessesARead-onlyIdempotentInspect
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 /v2/teams/:team_id/clarity-v2/processes/:process_id for v2 rows and GET /v2/teams/:team_id/clarity/processes/:id for legacy v1 rows. Both v1 (legacy) and v2 processes are returned by default; use search, status, and version to narrow discovery. Capped at 100 per page.
Inputs: limit, offset, search, status, +2 more.
listClarityProcessLabelsList Clarity Process LabelsBRead-onlyIdempotentInspect
List process tags available in an organization.
Inputs: orgId (required), limit, offset, search.
listClarityProcessLinksList Clarity Process LinksARead-onlyIdempotentInspect
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.
Inputs: orgId (required), limit, offset, node_id.
listClarityProcessMembersList Clarity Process MembersARead-onlyIdempotentInspect
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
Inputs: id (required), contributorsAfter.
listClarityProcessSnapshotsList Clarity Process SnapshotsBRead-onlyIdempotentInspect
List lightweight Clarity v2 process snapshots for one kind.
Inputs: kind (required), process_id (required), limit, offset.
listClarityProcessSummariesList Clarity Process SummariesARead-onlyIdempotentInspect
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 5, max 10). Use this to answer portfolio-wide questions in one pass; fetch a single process's full detail via getClarityProcessSnapshot only for the few that matter.
Inputs: limit, detail, offset, team_id, +1 more.
listClarityStepFramesList Clarity Step FramesARead-onlyIdempotentInspect
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 closest earlier frame as fallback. Pass window (1-5) to also receive that many neighbouring frames on each side as candidates, for recovering when the selected frame does not show the step. Pass size=thumb for 768px copies that are cheaper to download and inspect. Signed URLs are short-lived and can be null when signing is unavailable.
Inputs: process_id (required), snapshot_id (required), size, window, +1 more.
listClarityTeamInterviewsList Clarity Team InterviewsBRead-onlyIdempotentInspect
List team-level Clarity interviews
Inputs: limit, offset, team_id.
listConfigFieldsList Config FieldsARead-onlyIdempotentInspect
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.
Inputs: automation_id (required), include_hidden.
listConfigSectionsList Config SectionsARead-onlyIdempotentInspect
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.
Inputs: automation_id (required).
listConnectionsList ConnectionsARead-onlyIdempotentInspect
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 sharing setting is on. The type query parameter filters by integration type, not native OAuth provider key.
Inputs: type, limit, offset, team_id.
listCredentialsList credentials for user and teamARead-onlyIdempotentInspect
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 flags indicating whether they are set.
Inputs: userId (required), domain, team_id.
listIntegrationsList IntegrationsBRead-onlyIdempotentInspect
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 via this API; use the Duvo dashboard to complete OAuth-based connections.
Inputs: type, limit, offset, team_id.
listMyOrganizationsList My OrganizationsARead-onlyIdempotentInspect
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 admin-or-above role before calling organization-scoped endpoints, which reject lower roles with 403.
Inputs: no named parameters.
listMyTeamsList My TeamsARead-onlyIdempotentInspect
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.
Inputs: no named parameters.
listNotificationsList NotificationsARead-onlyIdempotentInspect
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 list only the live members of a notification batch, optionally ordered by sort=importance (only valid together with batchId). Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: sort, type, limit, cursor, +9 more.
listOrgAgentsList Org AgentsARead-onlyIdempotentInspect
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 agents were switched off' without a request per team or per agent. Requires an organization Admin, Executive, or Owner role, and an API key scoped to all teams you can access — a key pinned to a single team is rejected, because this endpoint spans every team in the organization.
Inputs: orgId (required), limit, offset, team_id, +2 more.
listOrgRunsList Org RunsARead-onlyIdempotentInspect
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 Admin, Executive, or Owner role, and an API key scoped to all teams you can access — a key pinned to a single team is rejected, because this endpoint spans every team in the organization.
Inputs: orgId (required), limit, since, until, +16 more.
listOrgTeamsList Org TeamsARead-onlyIdempotentInspect
List teams belonging to an organization you are a member of, including your membership and role in each.
Inputs: orgId (required), limit, offset, search, +1 more.
listPluginCatalogList Plugin CatalogARead-onlyIdempotentInspect
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.
Inputs: no named parameters.
listProcessRolesList Process RolesARead-onlyIdempotentInspect
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 which role" and "what does each role see" on an automation from this, not from team membership or dashboard sharing. Each role has its key (pass it to assignProcessMember), label, can_act_on_cases, can_view_manage, the dashboards it opens, its members and its pending_invites. dashboards_shared_individually are pinned dashboards a role alone does not open: say they must be shared with the person too. dashboards_creator_only read a live Connection and open only for their creator. When roster.complete is false the lists were cut off: say so, give the totals, and point to the People tab (urls.people) instead of saying who holds a role. Give the user the full urls, not the paths. Managers and above only.
Inputs: automation_id (required).
listPulseDashboardCommentsList Pulse Dashboard CommentsARead-onlyIdempotentInspect
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.
Inputs: artifactId (required), limit, offset, status.
listPulseDashboardConnectionsList Pulse Dashboard ConnectionsARead-onlyIdempotentInspect
List the connections (data sources) attached to a Duvo Pulse dashboard (requires edit access).
Inputs: artifactId (required).
listPulseDashboardMessagesList Pulse Dashboard MessagesARead-onlyIdempotentInspect
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 older messages. Messages from other version branches are not included.
Inputs: artifactId (required), limit, before.
listPulseDashboardsList Pulse DashboardsARead-onlyIdempotentInspect
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 after_id cursor without a concurrent change shifting a page boundary.
Inputs: limit, scope, offset, after_id.
listPulseDashboardVersionsList Pulse Dashboard VersionsARead-onlyIdempotentInspect
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.
Inputs: artifactId (required).
listQueueAgentsList Queue AgentsARead-onlyIdempotentInspect
List agents bound to a queue as producers (agents that push cases into the queue) or consumers (agents triggered by cases in the queue).
Inputs: queue_id (required).
listQueueAggregationsList Queue AggregationsBRead-onlyIdempotentInspect
List a queue's aggregation definitions.
Inputs: queue_id (required), limit, offset.
listQueueLabelsList Queue LabelsARead-onlyIdempotentInspect
List every label defined on a queue along with the count of cases each label is assigned to.
Inputs: queue_id (required), limit, offset.
listQueuesList QueuesBRead-onlyIdempotentInspect
List queues for your team.
Inputs: limit, offset, team_id, automation_id.
listRevisionIntegrationConnectionsList Revision Integration ConnectionsARead-onlyIdempotentInspect
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.
Inputs: agent_id (required), build_id (required), integration_id (required).
listRevisionIntegrationQueuesList Revision Integration QueuesARead-onlyIdempotentInspect
List the queues linked to this build's case-queue integration slot. Only meaningful for case-queue-producer and case-queue-consumer integrations.
Inputs: agent_id (required), build_id (required), integration_id (required).
listRevisionIntegrationsList Revision IntegrationsBRead-onlyIdempotentInspect
List integrations attached to an agent revision.
Inputs: agent_id (required), build_id (required).
listRevisionLoginsList Revision LoginsARead-onlyIdempotentInspect
List logins attached to a specific revision (build) of an assignment. Returns metadata only — passwords and OTP secrets are never exposed.
Inputs: agentId (required), buildId (required).
listRevisionSecretsList Revision SecretsARead-onlyIdempotentInspect
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.
Inputs: agentId (required), buildId (required).
listRunMessagesList Run MessagesARead-onlyIdempotentInspect
Get paginated messages for an agent run. Messages are returned in chronological order.
Inputs: run_id (required), limit, offset.
listRunsList RunsARead-onlyIdempotentInspect
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 response shape is returned with data: [] and the matching total. To sweep a whole team, follow next_cursor rather than raising offset.
Inputs: limit, since, until, cursor, +16 more.
listSandboxFilesList Sandbox FilesBRead-onlyIdempotentInspect
List files in a sandbox directory.
Inputs: sandbox_id (required), path.
listSecretsList SecretsARead-onlyIdempotentInspect
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; secret values are never exposed.
Inputs: team_id.
listSkillAssignmentsList Skill AssignmentsARead-onlyIdempotentInspect
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.
Inputs: skill_id (required).
listSkillFilesList Skill FilesARead-onlyIdempotentInspect
List all files in a skill.
Inputs: skill_id (required).
listSkillRevisionFilesList Skill Revision FilesARead-onlyIdempotentInspect
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.
Inputs: skill_revision_id (required), limit, cursor.
listSkillRevisionsList Skill RevisionsARead-onlyIdempotentInspect
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.
Inputs: skill_id (required), limit, offset.
listSkillsList SkillsARead-onlyIdempotentInspect
List all skills for the current team, including system skills.
Inputs: team_id.
listSystemSkillsList System SkillsARead-onlyIdempotentInspect
List all system skills (skills available to all teams).
Inputs: no named parameters.
listTeamInvitesList Team InvitesARead-onlyIdempotentInspect
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.
Inputs: team_id, processId.
listTeamMembersList Team MembersARead-onlyIdempotentInspect
List members of a team. The authenticated session or API key must be scoped to the requested team.
Inputs: limit, offset, search, team_id.
markAllNotificationsReadMark All Notifications ReadAIdempotentInspect
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.
Inputs: team_id.
markNotificationBatchReadMark Notification Batch ReadAIdempotentInspect
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 severity) to narrow it by urgency — e.g. the page's active filters; omit them to mark every live member. Narrowing matters when the batch card was rendered under a filter: the rows marked read should be the rows the card counted. Pass openedFrom to record which channel the reader came through, on every member this call marks read. Pass automation_id to mark only the members about that automation, the ones its Notifications tab lists; a batch with none of them returns 404. Returns the count of members that were updated. Requires the Notification Center feature; returns 404 when it is not enabled for the team or the batch does not exist or belongs to another recipient/team.
Inputs: id (required), types, team_id, severity, +3 more.
markNotificationReadMark Notification ReadADestructiveIdempotentInspect
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 already in Duvo, or email/slack/teams from the notificationSource param on an external link); omit it when the read is not somebody opening the notification. Requires the Notification Center feature; returns 404 when it is not enabled for the team.
Inputs: id (required), openedFrom.
moveAgentMove AgentAInspect
Move an agent (and its connected workspace) to a different team. Pass dry_run=true to preview the closure without applying changes.
Inputs: agent_id (required), target_team_id (required), dry_run, bypass_standalone_gate.
moveAgentsToFolderMove Agents To FolderAInspect
Move one or more agents (assignments) into a folder, or to the root level.
Inputs: agent_ids (required), folder_id (required), team_id.
moveAutomationsToFolderMove Automations To FolderAInspect
Move one or more automations into an agent folder, or to the root level.
Inputs: folder_id (required), automation_ids (required), team_id.
moveClarityProcessesToFolderMove Clarity Processes To FolderAInspect
Move processes into a folder (or back to Unfiled)
Inputs: folderId (required), processIds (required), team_id.
movePulseDashboardMove Pulse DashboardADestructiveInspect
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 Connections reconnect vs drop without applying changes.
Inputs: artifactId (required), targetTeamId (required), dryRun, team_id.
organizeClarityProcessLandscapeOrganize Clarity Process LandscapeAInspect
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.
Inputs: orgId (required), instructions.
pauseQueuePause QueueAInspect
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 activating or rolling back a revision does not change it. Pausing a paused queue changes nothing. Only a builder or team admin, or someone whose case trigger on the queue is on, can pause it. Pausing is rolling out and may not be available to every team yet; where it is not, the request answers 403. Resuming is always available.
Inputs: queue_id (required).
pinRevisionIntegrationConnectionPin Revision Integration ConnectionAInspect
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.
Inputs: agent_id (required), build_id (required), connection_id (required), integration_id (required).
postprocessClaritySnapshotPostprocess Clarity SnapshotAInspect
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 immediately; agents run asynchronously and flip the status back to review once they settle.
Inputs: type (required), process_id (required), scope, current_process_id, +1 more.
postRunMessagePost Run MessageAInspect
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 sandbox_expired.
Inputs: run_id (required), message (required).
previewAgentCaseTriggerConflictsPreview Agent Case Trigger ConflictsARead-onlyIdempotentInspect
Preview which other agents would conflict with this agent's case trigger if it pointed at the given queue. Does not modify the trigger.
Inputs: agent_id (required), case_queue_id (required).
probeMcpServerProbe an MCP server for available toolsAInspect
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 writes; sits alongside /v2/teams/:team_id/connections/oauth/mcp/check (which probes the same URL for OAuth support).
Inputs: headers, team_id, server_url, integration_slug.
promoteClarityProcessSnapshotPromote Clarity Process SnapshotADestructiveInspect
Promote a draft or historic Clarity v2 snapshot to live for its kind.
Inputs: kind (required), process_id (required), snapshot_id (required).
promoteRevisionPromote RevisionADestructiveInspect
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 runs. Fails if the revision is already live, if a draft revision still has an active builder run, or with 409 if the agent's automation runs as the team and the revision sends cases to a queue that is not in a team automation.
Inputs: build_id (required), revision_name, revision_description.
promoteSkillRevisionPromote Skill RevisionADestructiveIdempotentInspect
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 revision_name / revision_description supplied in the body.
Inputs: skill_revision_id (required), revision_name, revision_description.
proposeClarityLandscapeProcessPropose Clarity Landscape ProcessBInspect
Create a manual process in the organization's Process Landscape, either as an unassigned proposal or atomically assigned to an eligible team.
Inputs: name (required), orgId (required), teamId, parentId, +2 more.
publishPulseDashboardPublish Pulse DashboardAInspect
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 on it); organization-wide viewers outside the team always get view-only access.
Inputs: artifactId (required), visibility (required), permission.
readAutomationDashboardDataRead Automation Dashboard DataARead-onlyIdempotentInspect
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 where the label alone leaves the figure unclear and a note for what the tile shows besides it. Call this for any number on a Module dashboard instead of reading the dashboard's HTML (getPulseDashboardHtml refuses Module dashboards for size) or paging through Cases: a recount can disagree with the tile the user sees. Pass dashboard_id for one dashboard, or leave it out for every dashboard of the automation the caller may open. range applies to dashboards with a time range control; the result names the range it read. Pass time_zone with the user's IANA zone so a day starts at their midnight, as their dashboard's do; without it days start at midnight UTC, and range.time_zone says which zone was used. Quote display, say the period it covers, and name and link the dashboard with its link. A dashboard whose figures are not declared, or that was changed since it was installed, comes back unsupported; one that could not be read comes back error; both carry a hint. Needs Queues on the team's plan. Each link is a path in the Duvo web app; give the user the full URL beside it (url).
Inputs: automation_id (required), range, time_zone, dashboard_id.
readAutomationPolicyRead Automation PolicyARead-onlyIdempotentInspect
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 counts them (required_open is what still blocks a run) apart from the module's pre-filled module_defaults; answers proposed by interviews and waiting for review; accepted and pending process-context notes; the interviews assigned; and pending_apply, the structural answers and notes not yet written into an Agent. running says whether the automation runs on live work: there a changed answer reaches its Agents from their next run, so name the question, its current answer and the new one, and change it only after the user says yes. A question whose bindings include structural changes how the Agents run; propose the matching Agent change too. Never invent an answer for a question shown as open. Give the user the full URLs in urls.
Inputs: automation_id (required), include_hidden.
refreshPulseDashboardRefresh Pulse DashboardAInspect
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.
Inputs: artifactId (required).
refreshQueueAggregationRefresh Queue AggregationBInspect
Force a fresh recompute of an aggregation definition.
Inputs: queue_id (required), definition_id (required).
rejectAgentSuggestionReject Agent SuggestionCDestructiveInspect
Dismiss a pending suggestion.
Inputs: id (required).
removeAutomationAgentRemove Automation AgentADestructiveIdempotentInspect
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 standalone agent delete does. On a team that changes its automations by revision, an agent the active revision binds is refused: activate a revision that omits it first.
Inputs: agent_id (required), automation_id (required).
removeAutomationQueueRemove Automation QueueADestructiveIdempotentInspect
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 the team changes its automations by revision.
Inputs: automation_id (required), case_queue_id (required).
removeClarityLandscapeNodePersonRemove Clarity Landscape Node PersonBDestructiveIdempotentInspect
Remove a person from the process behind a process landscape node, and revoke the process access they were granted when they were added.
Inputs: orgId (required), nodeId (required), personId (required), teamId, +1 more.
removeClarityProcessMemberRemove Clarity Process MemberADestructiveIdempotentInspect
Remove accepted access to a clarity process
Inputs: id (required), invitationId (required).
removeConfigSectionRemove Config SectionADestructiveIdempotentInspect
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.
Inputs: section_key (required), automation_id (required).
removeRevisionIntegrationRemove Revision IntegrationADestructiveIdempotentInspect
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.
Inputs: agent_id (required), build_id (required), integration_id (required), selected_automation_revision_id.
removeTeamMemberRemove Team MemberADestructiveIdempotentInspect
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 the organization can only leave voluntarily.
Inputs: memberId (required), team_id.
renameConfigSectionRename Config SectionADestructiveInspect
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 template reinstall keeps the rename.
Inputs: name (required), section_key (required), automation_id (required).
renameFileRename FileCDestructiveInspect
Rename a file in team storage.
Inputs: relativePath (required), newFilenameOnly (required), team_id.
reorderClarityFoldersReorder Clarity FoldersADestructiveInspect
Reorder the team's process folders to match the given id order. The payload must name every folder exactly once.
Inputs: folderIds (required), team_id.
reorderClarityLandscapeAreasReorder Clarity Landscape AreasADestructiveIdempotentInspect
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 setClarityLandscapeNodePlacement to move a node to a different parent.
Inputs: orgId (required), orderedAreaIds (required), parentId.
reorderConfigSectionsReorder Config SectionsADestructiveIdempotentInspect
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 template reinstall keeps the order of the sections moved here.
Inputs: keys (required), automation_id (required).
replaceCaseQueueEvalRubricsReplace Case Queue Eval RubricsADestructiveInspect
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 the new set. An empty list is refused — whole-case evaluation regenerates rubrics for an empty set at the next settlement, so a cleared set would not stay cleared; remove individual rubrics instead. Targets the queue's current version (build-set), which exists once its first Agent-processed case settles — this fails with 409 before then. Cases already judged keep their original verdicts.
Inputs: rubrics (required), queue_id (required).
replaceEvalRubricsReplace Eval RubricsADestructiveInspect
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 set; pass an empty array to clear them. Defaults to the Agent's live build; pass build_id to target a specific revision.
Inputs: agentId (required), rubrics (required), build_id, selected_automation_revision_id.
replaceRevisionIntegrationQueuesReplace Revision Integration QueuesADestructiveIdempotentInspect
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 getRevisionCaseQueueSetup to confirm the slot now reports linked_queue_count > 0.
Inputs: agent_id (required), build_id (required), queue_ids (required), integration_id (required), +1 more.
respondToHumanRequestRespond To Human RequestAInspect
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.
Inputs: run_id (required), request_id (required), answers, approved.
restoreConfigFieldRestore Config FieldBDestructiveInspect
Show a hidden Policy question again, with the answer it had.
Inputs: field_id (required), automation_id (required).
restorePulseDashboardVersionRestore Pulse Dashboard VersionBDestructiveInspect
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.
Inputs: artifactId (required), revisionId (required).
resumeBuilderRunResume Builder RunAInspect
Resume a builder run that is waiting for user input
Inputs: answers (required), builder_run_id (required).
resumeQueueResume QueueAInspect
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 on, can resume it.
Inputs: queue_id (required).
revertClarityProcessSnapshotRevert Clarity Process SnapshotADestructiveIdempotentInspect
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.
Inputs: kind (required), process_id (required), snapshot_id (required).
saveClarityProcessSnapshotSave Clarity Process SnapshotBInspect
Save user edits as the live Clarity v2 snapshot for the selected kind.
Inputs: kind (required), steps (required), process_id (required), baselineSnapshotId (required), +5 more.
searchCasesSearch CasesAInspect
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 enough. Each json_data entry is {path, operator, value} where path is a declared scalar in JSONPath dotted form ($.invoice.amount); entries are ANDed, so two comparisons on one path express a range. A path the queue's Case schema does not declare is rejected rather than ignored, as is a value that does not match the field's declared type. The contains operator is case-sensitive (unlike the free-text search parameter). Set count_only=true to skip Case row selection, enrichment, and transformation. The normal response shape is returned with cases: [] and the matching total.
Inputs: queue_id (required), limit, offset, search, +5 more.
sendClarityInterviewInvitesSend Clarity Interview InvitesAInspect
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, then pass them as invitees. Set includeProcessPeople to true to also invite everyone already listed as a person on this process. At most 25 unique recipients per call. Each invitee gets a Clarity process invitation, exactly as the Invite dialog creates one; someone already invited is sent their invitation again rather than a second one. Where the team has account-free interview links on, people without a Duvo account get a link that opens the interview directly and expires after 30 days, or seven days after a scheduled interview ends if that is later; everyone else gets the normal invitation that asks them to sign in. Pass schedule to book the interview: the email then carries a calendar invite for that time, sending again with a new time moves the same calendar event, and revoking the invitation cancels it. Revoke a pending invitation with deleteTeamInvite.
Inputs: id (required), message, invitees, schedule, +1 more.
sendPulseDashboardMessageSend Pulse Dashboard MessageAInspect
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 regenerates asynchronously — poll GET /artifacts/{artifactId} for status.
Inputs: message (required), artifactId (required), attachments, from_revision_id, +1 more.
sendTeamInviteEmailSend Team Invite EmailAInspect
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 server-configured app origin.
Inputs: id (required), team_id, schedule, frontendUrl.
setCaseJsonDataFieldsSet Case Json Data FieldsADestructiveInspect
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 write reads and locks the latest payload in the database, so a concurrent edit to another field, or to another item of the same array, is preserved. Each set entry names a path, a JSONPath declared in the queue's current Case schema, and the value to store there. A path is dotted object fields ($.invoice.amount) with optional array indices in brackets ($.lines[0] for a whole item, $.lines[0].amount for one field of it). An index must name an item that already exists; an out-of-range index or a non-array parent is refused, and a write never adds or removes items. A value can be any JSON value, including an object for an object field. Paths must be distinct, and no path may sit inside another in the same request ($.lines beside $.lines[0], or $.lines[0] beside $.lines[0].amount). An index names a position, so when the array can change between your read and your write, add expect entries that pin the item, such as its id field ($.lines[0].id): if any stored value differs, nothing is written and the response is a 409. The resulting payload is validated against the queue's current Case schema and the case is re-pinned to that schema version; if any entry is refused, nothing is written. A case without a structured payload yet must be given one with PATCH /cases/{case_id} first. Returns the updated case with its event history and approval batches.
Inputs: set (required), case_id (required), expect.
setClarityLandscapeNodePlacementSet Clarity Landscape Node PlacementBDestructiveIdempotentInspect
Move a process landscape node (team builder or above for team processes; team manager or above for team proposals; organization admin for areas)
Inputs: orgId (required), nodeId (required), parentId (required).
setClarityLandscapePrioritiesSet Clarity Landscape PrioritiesBDestructiveIdempotentInspect
Set or clear heatmap priorities in one batch (team managers for their processes; organization admin+ across the organization)
Inputs: org_id (required), priorities (required).
setPulseDashboardCommentResolutionSet Pulse Dashboard Comment ResolutionADestructiveInspect
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.
Inputs: resolved (required), commentId (required), artifactId (required).
setupClarityFoldersFromLandscapeSetup Clarity Folders From LandscapeBInspect
Create one linked folder per landscape group node containing this team's processes. Idempotent: groups that already have a linked folder are skipped.
Inputs: team_id.
setUpModuleSet Up ModuleADestructiveInspect
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, Queues, Policy and dashboards in one call. If the team already has a demo of this Module open, the call is refused with 409 unless convert_existing_demo is true; then that demo becomes the Automation and its sample cases and Runs are deleted, so ask the user first. The Automation starts in setup and does not run yet: call getAutomationReadiness next to see what is left of the setup, the Policy questions, the current process and the automation proposal, whose approval builds the automation. Connections and routing come once the approved proposal is being built, so don't raise them before. Give the user the url.
Inputs: slug (required), team_id, convert_existing_demo.
startClarityExportStart Clarity ExportCInspect
Start a Clarity → SAP Signavio export job
Inputs: bpmnXml (required), processId (required), connectionInstanceId (required), team_id, +2 more.
startNativeOAuthStart Native OAuthAInspect
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 that must be opened in a browser by a human end-user; once they grant consent, Duvo creates the matching connection and redirects the browser to the optional return_url (or the Duvo dashboard if none is provided). Poll /v2/teams/:team_id/connections to detect the new connection.
Inputs: provider (required), team_id, return_url, reconnect_instance_id.
startRunStart RunAInspect
Start a new agent run. Returns immediately with run info - does not wait for completion.
Inputs: agent_id (required), message, team_id, sandbox_id, +1 more.
stopClarityArtifactChatConversationStop Clarity Artifact Chat ConversationADestructiveInspect
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.
Inputs: process_id (required), conversation_id (required).
stopClarityProcessSnapshotStop Clarity Process SnapshotADestructiveInspect
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 dropped as stale.
Inputs: kind (required), process_id (required).
stopPulseDashboardMessageStop Pulse Dashboard MessageADestructiveInspect
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.
Inputs: artifactId (required), partial_text.
stopRunStop RunADestructiveInspect
Stop an agent run. No-op if the run is not currently running.
Inputs: run_id (required).
unlinkCaseLabelsUnlink Case LabelsBDestructiveInspect
Remove the given labels from a case.
Inputs: case_id (required), queue_id (required), label_ids (required).
unlinkClarityProcessLabelsUnlink Clarity Process LabelsCDestructiveInspect
Remove process tags from a process.
Inputs: id (required), labelIds (required).
unpinRevisionIntegrationConnectionUnpin Revision Integration ConnectionADestructiveIdempotentInspect
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.
Inputs: agent_id (required), build_id (required), connection_id (required), integration_id (required).
updateAgentUpdate AgentCDestructiveInspect
Update an agent's display name or delivery settings.
Inputs: agent_id (required), name, pinned, thread_id, +5 more.
updateAgentCaseTriggerUpdate Agent Case TriggerADestructiveInspect
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.
Inputs: agent_id (required), trigger_id (required), enabled, concurrency, +1 more.
updateAgentFolderUpdate Agent FolderADestructiveInspect
Rename an agent folder or move it to a new parent.
Inputs: folder_id (required), name, parent_folder_id.
updateAutomationUpdate AutomationBDestructiveInspect
Update an automation, e.g. rename it. Only the fields present in the body are changed.
Inputs: automation_id (required), name.
updateAutomationTabsUpdate Automation TabsADestructiveIdempotentInspect
Replace the automation detail view's tab arrangement. Pinning, unpinning, reordering and hiding a tab are all expressed as a different arrangement.
Inputs: order (required), hidden (required), automation_id (required).
updateCaseUpdate CaseADestructiveInspect
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 queue to have one; a case that is already typed against a schema keeps its structured payload and rejects a free-text data write. Works on pending, in-progress, and settled cases. Other attributes (status, priority, labels) have their own dedicated endpoints. Returns the updated case with its event history and approval batches.
Inputs: case_id (required), data, title, json_data.
updateCaseQueueEvalRubricUpdate Case Queue Eval RubricADestructiveInspect
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.
Inputs: queue_id (required), rubric_id (required), title, description.
updateClarityFolderUpdate Clarity FolderADestructiveInspect
Rename a process folder. Renaming a landscape-linked folder permanently stops landscape name-sync.
Inputs: name (required), folderId (required), team_id.
updateClarityGuidanceUpdate Clarity GuidanceCDestructiveInspect
Update the automation guidance message for a clarity process
Inputs: id (required), content (required).
updateClarityLandscapeNodeUpdate Clarity Landscape NodeADestructiveInspect
Rename a process landscape node or update its owner label (team manager or above for team processes; organization admin for areas)
Inputs: orgId (required), nodeId (required), name, ownerLabel.
updateClarityLandscapeNodePersonUpdate Clarity Landscape Node PersonBDestructiveInspect
Change the role a person plays in the process behind a process landscape node (for example "Approver"). Send role: null to clear it.
Inputs: orgId (required), nodeId (required), personId (required), role, +1 more.
updateClarityOrganizationInterviewUpdate Clarity Organization InterviewCDestructiveInspect
Rename an organization landscape Clarity capture
Inputs: orgId (required), title (required), interviewId (required).
updateClarityProcessUpdate Clarity ProcessADestructiveInspect
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 change visibility, and completing or reopening a process for review requires a Lead Builder role.
Inputs: id (required), name, status, visibility, +6 more.
updateClarityProcessLabelUpdate Clarity Process LabelCDestructiveInspect
Update process tags for an organization.
Inputs: orgId (required), labelId (required), value, colorHue.
updateClarityProcessLinkUpdate Clarity Process LinkADestructiveInspect
Update a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams.
Inputs: orgId (required), process_link_id (required), type, state, +3 more.
updateClarityProcessSharingUpdate Clarity Process SharingCDestructiveInspect
Enable or disable sharing for a clarity process
Inputs: id (required), enabled (required), proposalShareEnabled.
updateClarityTeamSettingsUpdate Clarity Team SettingsDDestructiveInspect
Update Clarity team settings
Inputs: team_id, industry, language, teamSize, +9 more.
updateConfigFieldUpdate Config FieldADestructiveInspect
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 a running automation (running in readAutomationPolicy) the change reaches its Agents from their next run: name the question, its current answer and the new one, change it only after the user says yes, and pass the current answer you showed, not the new one, as expected_value so a change someone made in between is not overwritten. A compound question takes every part in one write. When the field's bindings include structural, the module's Agents also need a matching change; propose it.
Inputs: value (required), fieldId (required), automationId (required), expected_value.
updateConfigFieldDefinitionUpdate Config Field DefinitionADestructiveInspect
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 gets a new version, and a new section moves the field to that section's end. The type of a field added through the API can change while it has no answer; a field from the module template keeps its type. The answer is never changed, and a module template reinstall keeps the edit.
Inputs: field_id (required), automation_id (required), key, type, +8 more.
updateConnectionUpdate ConnectionADestructiveInspect
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.
Inputs: connection_id (required), name, shared, headers, +2 more.
updateCredentialUpdate credential by idADestructiveInspect
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.
Inputs: id (required), userId (required), domain, shared, +4 more.
updateEvalRubricUpdate Eval RubricADestructiveInspect
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.
Inputs: agentId (required), rubricId (required), title, description, +1 more.
updateFileContentUpdate File ContentCDestructiveIdempotentInspect
Update the content of a text file.
Inputs: path (required), content (required), team_id.
updatePulseDashboardUpdate Pulse DashboardBDestructiveInspect
Update a Duvo Pulse dashboard's settings — rename it. Only the creator can update it.
Inputs: title (required), artifactId (required).
updateQueueUpdate QueueCDestructiveInspect
Update a queue.
Inputs: queue_id (required), name, folder_id, description.
updateQueueLabelUpdate Queue LabelADestructiveInspect
Update a label's key, value, or color. Renaming key/value affects every case assigned to this label.
Inputs: value (required), label_id (required), queue_id (required), key, +1 more.
updateRevisionUpdate RevisionCDestructiveInspect
Update a revision's configuration, name, description, or handover targets. Returns the updated revision.
Inputs: build_id (required), config, handoverTo, revision_name, +4 more.
updateScheduleUpdate ScheduleADestructiveInspect
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 schedule that belongs to an automation with revisions keeps firing as its automation's active revision says: a change to its timing is saved to the automation's draft and takes effect when the draft is made active (see pending_change), while enabled applies at once.
Inputs: agent_id (required), schedule_id (required), day, cron, +6 more.
updateSecretUpdate SecretADestructiveInspect
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.
Inputs: id (required), name, shared, values, +4 more.
updateSkillFileUpdate Skill FileADestructiveIdempotentInspect
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 edit it, promoteSkillRevision to activate it. Only team skills can be edited.
Inputs: path (required), content (required), skill_id (required).
updateSkillRevisionUpdate Skill RevisionADestructiveInspect
Rename a skill revision or change its description. Works for drafts, the active revision, and historic revisions.
Inputs: skill_revision_id (required), revision_name, revision_description.
updateSkillRevisionFileUpdate Skill Revision FileADestructiveIdempotentInspect
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: create a draft from one to edit it.
Inputs: path (required), content (required), skill_revision_id (required).
updateSlackTriggerUpdate Slack Channel TriggerADestructiveInspect
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 off to still be available on the agent; changing the channel resets the trigger's seen-message state.
Inputs: trigger_id (required), enabled, channel_id, is_private, +2 more.
updateTeamInviteUpdate Team InviteADestructiveInspect
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.
Inputs: id (required), role (required), team_id.
updateTeamMemberRoleUpdate Team Member RoleADestructiveInspect
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 cannot be changed here.
Inputs: role (required), memberId (required), team_id.
upgradeClarityProcessUpgrade Clarity ProcessADestructiveInspect
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.
Inputs: id (required).
uploadCodeStepFileUpload Code Step FileAIdempotentInspect
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. Uploading does not change a revision or make code live.
Inputs: content (required), agent_id (required).
uploadSandboxFileUpload Sandbox FileAInspect
Upload a file directly to the sandbox. Maximum file size is 10MB. For larger files, use POST /v2/sandboxes/:sandbox_id/upload-urls.
Inputs: sandbox_id (required).
upsertAgentTriggerUpsert Agent TriggerADestructiveIdempotentInspect
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 without deleting it. An agent holds one trigger per integration for a user, so a save with a different trigger_type replaces the existing one — except when that trigger is an @mention trigger, which is managed from the agent's mention setting and answers 409 (mention_trigger_protected) here. @mention triggers are best managed from that setting throughout: this route leaves an existing one's filter_config untouched, and refuses to create a teams_mention trigger without a filter_config.tenantId (400, mention_trigger_workspace_required) — a Slack mention trigger has no equivalent field to supply.
Inputs: agentId (required), trigger_type (required), integration_slug (required), enabled, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Runtime AI governance: decision gates, human approval, hash-chained audit, compliance mapping.
Run your organization's AIOS workflows as tools, with its approvals, audit trail and access rules.
Execute governed business decisions via AI agents. Agents draft rule changes; humans always approve.
Governed MCP workflow automation for MSPs and agencies: approvals, durable state, signed evidence.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides four MCP servers for retail/CPG operations (ERP, supplier network, email, spreadsheet) with a staged-write safety model that requires human approval for all mutations.11Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to securely call enterprise MCP tools with tenant-scoped RBAC, human approvals, audit logging, and multi-tool workflows across customer, order, document, and ticket data.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to look up customers, orders, products, and stock; take role-restricted actions such as creating orders and handling refunds; enforce business rules; and maintain a tamper-evident audit log.MIT
- AlicenseCqualityBmaintenanceEnables running and monitoring 19 agentic business use-case engines with MCP orchestration, memory evolution, and approval gates.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.