io.github.duvoai/duvo

Tools

• acceptClarityCaptureSuggestion

  Accept a pending Process Landscape capture suggestion and create the durable capture request (manager+).

  shallow
• acceptClarityLandscapeNode

  Accept a proposed area folder into the active process landscape, so it stops being a proposal and becomes part of the real structure (organization admin+). Only area folders can be accepted; a proposed process becomes real through assignClarityLandscapeNodeTeam instead. Re-accepting an already-active area is a no-op.

  shallow
• acceptClarityProcessJoin

  Accept a clarity interview invite link and gain process access.

  shallow
• acceptClarityTeamAssignmentSuggestion

  Accept a pending Process Landscape team-assignment suggestion and durably assign the suggested team (manager+).

  shallow
• addClarityLandscapeNodePerson

  Add a person involved in the process behind a process landscape node. Name only records a placeholder; supplying an email also gives that person access to the process and emails them an invitation, so only pass an email the user asked you to invite.

  shallow
• answerPulseDashboardQuestion

  Answer a pending question the Duvo Pulse agent asked and resume the paused run (creator or team editors). Use the toolCallId from the dashboard's message transcript.

  shallow
• assignCaseLabels

  Assign one or more labels to a case. Creates the labels on the queue if they don't already exist.

  shallow
• assignClarityExtraCaptureRequest

  Assign (or unassign, with `user_id: null`) a team member to fulfil an extra-capture request. Restricted to admins and managers.

  shallow
• assignClarityLandscapeCaptureRequest

  Assign an open Process Landscape capture request to a team member, or unassign it by sending userId: null (manager+).

  shallow
• assignClarityLandscapeNodeTeam

  Set the owning team of a process in the process landscape (organization admin+). On a proposed process this accepts the proposal and creates the real process for that team; on an existing process it moves the process, its captures and its brief to another team.

  shallow
• assignClarityProcessLabels

  Assign process tags to a process.

  shallow
• attachPulseDashboardConnection

  Attach one of your connections (data sources) to a Duvo Pulse dashboard so the agent can use its tools (creator only).

  shallow
• attachRevisionIntegrations

  Attach one or more integrations to an agent revision. To pin specific connections after attachment, use pinRevisionIntegrationConnection. IMPORTANT for the case-queue-producer and case-queue-consumer integrations: attaching the 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.

  shallow
• attachRevisionLogin

  Attach a login to a revision so the agent can use it during Runs spawned from that revision. Personal logins can only be attached by their owner; team-shared logins require builder permissions.

  shallow
• attachRevisionSecret

  Attach an env-var secret to a revision so its keys are injected into Runs spawned from that revision. Personal secrets can only be attached by their owner; team-shared secrets require builder permissions.

  shallow
• authorizeMcpOAuth

  Start an OAuth-based connection with a remote MCP server using Dynamic Client Registration. 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 `returnUrl`.

  shallow
• batchAddClarityLandscapeNodePeople

  Add one or more people to multiple Process Landscape nodes in a bounded batch. Email entries can create invitations; each node-person outcome reports success, conflict, or delivery failure.

  shallow
• buildClarityAutomation

  Hand a transformation 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.

  shallow
• bulkCreateTeamInvites

  Invite several people to a team in one call, emailing each invitation immediately. Returns per-batch counts: `succeeded` were invited, `skipped` were already on the team, already had a pending invitation, or were a duplicate of an 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.

  shallow
• bulkReprocessCases

  Re-process multiple cases on a chosen agent. Any active runs on the selected cases are interrupted first; the cases are then reset to pending and assigned to the chosen agent for the next dispatcher tick. The chosen agent must already be connected to the queue as a case-queue-consumer (with the trigger enabled or disabled).

  shallow
• bulkUpdateCasePriority

  Set the priority of multiple cases. Priority only affects the order pending cases are picked up in: due postponed cases are handled first, then higher priority. It never interrupts runs or changes case status. Set `none` to clear priority back to the default.

  shallow
• bulkUpdateCaseStatus

  Update the status of multiple cases to pending, completed, failed, or canceled. Interrupts any active runs and releases their case ownership, but never cancels their human-in-the-loop state — pending requests and open approval batches stay answerable/resolvable from the run view. Resetting to pending re-dispatches cases to the queue's trigger consumer.

  shallow
• checkMcpOAuth

  Probe an MCP server URL to discover whether it supports OAuth Dynamic Client Registration. Returns the authorization endpoint and required scopes when supported. Useful as a precursor to `/v2/teams/:team_id/connections/oauth/mcp/start` or `/v2/teams/:team_id/connections`. Performs no writes.

  shallow
• completeClarityArtifactImport

  Complete a Miro artifact import after uploading to the signed URL. The uploaded bytes are validated before the import becomes a usable Clarity capture.

  shallow
• completeClarityDocumentUpload

  Complete a document capture after uploading to GCS via signed URL

  shallow
• completeClarityImageUpload

  Complete an image capture after uploading it to GCS via a signed URL

  shallow
• completeClarityOrganizationDocumentUpload

  Complete an organization document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation

  shallow
• completeClarityTeamDocumentUpload

  Complete a team document capture after uploading to GCS; extracts text and stores it as a transcript so it feeds Process Landscape generation

  shallow
• completeClarityVideoUpload

  Complete a video capture after uploading to GCS via signed URL

  shallow
• consumeAgentSuggestion

  Apply a suggestion: stage its change into the Agent's draft revision, then auto-clear any pending suggestions it makes moot.

  shallow
• createAgent

  Create a new agent. Optionally include a build configuration to create the first build in the same request.

  shallow
• createAgentCaseTrigger

  Create a case trigger for an agent. An agent may have at most one case trigger; this returns 409 if one already exists.

  shallow
• createAgentFolder

  Create a new agent folder.

  shallow
• createAgentSlackTrigger

  Create a Slack channel trigger on an agent (Agent in the Duvo UI): the agent starts a Run whenever a matching message is posted in the channel. An agent can carry one trigger per channel, so call this once per channel. The Slack 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.

  shallow
• createCaseAttachmentUploadUrl

  Issue a signed URL for uploading a file to a case. The client must PUT the bytes to the returned URL with the returned Content-Type, then call the finalize endpoint so the attachment becomes visible on the case.

  shallow
• createCaseQueueEvalRubric

  Add one case-level evaluation rubric to a queue's current rubric set. Case-level rubrics judge the whole case (across every Run that touched it) as a Pass/Fail question at settlement. The rubric is added to the queue's current version (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.

  shallow
• createCases

  Create one or more cases in a queue. Provide either a single `case` object or a `cases` array (1-100); providing both returns 400. Each case accepts a title (max 500 chars), optional free-form `data`, 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.

  shallow
• createClarityArtifactImportUploadUrl

  Create a signed upload URL for importing a Miro export into a Clarity v2 process. Supports SVG, XML, PNG, and JPEG exports. The caller must upload the file to the returned URL, then complete the import.

  shallow
• createClarityDocumentUploadUrl

  Create a signed URL for uploading a PDF, TXT, Markdown, or BPMN document directly to GCS

  shallow
• createClarityFolder

  Create a process folder

  shallow
• createClarityGuidance

  Create a new transformation guidance message for a clarity process

  shallow
• createClarityImageUploadUrl

  Create a signed URL for uploading a PNG, JPEG, or WebP image directly to GCS

  shallow
• createClarityInviteLink

  Create or regenerate a process-scoped Clarity interview invite link. Only the process creator or team managers can create invite links; creating a new link invalidates any prior active link for the process.

  shallow
• createClarityLandscapeNode

  Create an area folder in the process tree. An active area (the default) requires organization admin+; a "proposal" area may be added by any organization member.

  shallow
• createClarityOrganizationDocumentUploadUrl

  Create a signed URL for uploading a PDF, TXT, Markdown, or BPMN document as an organization-level Clarity capture

  shallow
• createClarityProcess

  Create a new Clarity v2 process for the current team (Builder+). Optional `name` defaults server-side when omitted. Response uses camelCase `createdAt` to match existing FE clients.

  shallow
• createClarityProcessLabel

  Create process tags for an organization.

  shallow
• createClarityProcessLink

  Create a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams. If the same live source, target, and type already exists, the existing link is returned.

  shallow
• createClarityProcessNode

  File an existing Clarity process into an area of the process landscape (team manager or organization admin+). Use this for a process that already exists but sits in Unsorted; use proposeClarityLandscapeProcess to create a brand-new one.

  shallow
• createClarityTeamDocumentUploadUrl

  Create a signed URL for uploading a PDF, TXT, Markdown, or BPMN document as a team-level Clarity capture

  shallow
• createClarityVideoUploadUrl

  Create a signed URL for uploading a video file directly to GCS

  shallow
• createConnection

  Create a new user-provided connection (custom MCP server) for the current team. 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.

  shallow
• createCredential

  Create a login. At least one of `password` or `otp_secret` must be provided. Personal by default; pass `shared: true` to create a team-shared login (requires manager role).

  shallow
• createCustomIntegration

  Create a custom integration type (team-level catalog entry) that users can then connect as user-provided MCP connections. Requires manager-or-above role.

  shallow
• createEvalRubric

  Add one Agent-specific evaluation rubric to a build. A build may hold at most 5 custom rubrics; this fails with 409 once that ceiling is reached. Defaults to the Agent's live build; pass build_id to target a specific revision.

  shallow
• createFileUploadUrl

  Generate a signed URL for uploading a file directly to GCS.

  shallow
• createOrgTeam

  Create a new team under an organization you administer. Requires an organization Admin, Executive, or Owner role.

  shallow
• createPulseDashboard

  Create a new Duvo Pulse dashboard from a natural-language prompt (e.g. 'open cases by queue this week') and dispatch the first generation turn. Generation is asynchronous — poll GET /artifacts/{artifactId} until status is completed. The 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).

  shallow
• createPulseDashboardAttachmentUploadUrl

  Issue a presigned upload URL for a file to attach to a Duvo Pulse dashboard message (e.g. an HTML dashboard to copy, or a screenshot to match). POST the file bytes to the returned upload_url as multipart form data under the field name '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.

  shallow
• createQueue

  Create a new queue.

  shallow
• createQueueLabel

  Create a label on a queue without assigning it to a case.

  shallow
• createRevision

  Create a new revision for an existing agent.

  shallow
• createSandbox

  Create a new sandbox for file uploads. The returned sandbox_id can be passed to POST /v2/teams/:team_id/runs to stage data for a run.

  shallow
• createSandboxUploadUrl

  Get a presigned URL for uploading a file into a sandbox. Use for files larger than 10MB; smaller files can be uploaded directly via POST /v2/sandboxes/:sandbox_id/files.

  shallow
• createSchedule

  Create a schedule for an agent. The schedule fires against the agent's live build. The authenticated user owns the schedule.

  shallow
• createSecret

  Create an env-var secret. Personal by default; pass `shared: true` to create a team-shared secret (requires manager role).

  shallow
• createSkill

  Create or update a skill from a JSON body. The server constructs SKILL.md from the provided fields and stores it. If a skill with the same name already exists in the team, it is updated.

  shallow
• createSkillRevision

  Open a draft revision of a skill, copying its files from the active revision (or from `source_revision_id`). Edit the draft with updateSkillRevisionFile, 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`.

  shallow
• createTeamInvite

  Invite one person to a team. Pass `processId` to invite them to a specific Clarity process instead of the whole team (that requires the `team:clarity-member` role). Creating the invitation does NOT email anyone — call sendTeamInviteEmail with the returned id to deliver it, or use bulkCreateTeamInvites, which creates and emails in one step.

  shallow
• createTeamInviteLink

  Create or regenerate the team's shareable invite link — the one URL anyone can use to join the team. Regenerating invalidates the previous link, so anyone still holding the old URL can no longer join. Requires the Manager role or above.

  shallow
• declineClarityLandscapeNode

  Reject a proposed process landscape node while it is still a proposal, removing it and any proposed descendants. Real processes nested underneath survive and move back to Unsorted. Only proposals can be declined — an accepted node is removed with deleteClarityLandscapeNode.

  shallow
• deleteAgent

  Delete an agent and cascade-clean its schedules, case triggers, builder runs, and handover targets. Any active jobs are interrupted and their sandboxes paused.

  shallow
• deleteAgentCaseTrigger

  Delete a case trigger. Only the trigger creator or a builder/admin can delete it.

  shallow
• deleteAgentFolder

  Delete an agent folder. If the folder contains assignments or subfolders, pass `force=true` to delete it and move the contained assignments to the root level.

  shallow
• deleteAllNotifications

  Soft-delete all notifications for the authenticated user's current team, read or unread. Returns the count of notifications that were deleted. Destructive — only call on explicit user request, never bulk-delete unprompted. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

  shallow
• deleteCase

  Delete a case. Interrupts any associated active runs first.

  shallow
• deleteCaseAttachment

  Remove a file from a case. The row is soft-deleted; deletion of the stored object is attempted best-effort.

  shallow
• deleteCaseQueueEvalRubric

  Remove a single case-level evaluation rubric. Cases settled after this are no longer judged against it; already-judged cases keep their original verdicts. Removing the queue's last remaining rubric is refused with 409 — whole-case evaluation regenerates rubrics for an empty set at the next settlement, so the removal would not stay removed.

  shallow
• deleteClarityArtifactChatConversation

  Soft-delete an open or running artifact-chat conversation for the current user.

  shallow
• deleteClarityCapture

  Delete a capture from a clarity process

  shallow
• deleteClarityFolder

  Delete a process folder. Contained processes fall back to Unfiled.

  shallow
• deleteClarityLandscapeNode

  Soft-delete a tree node and its descendants. Organization admins may delete any subtree; team managers may delete a childless process node owned by their team. The targeted node's linked clarity process and captures are deleted, while nested processes detach to the Unsorted bag.

  shallow
• deleteClarityLandscapeNodeInterview

  Delete an organization-scoped folder interview

  shallow
• deleteClarityOrganizationInterview

  Delete an organization-level Clarity interview

  shallow
• deleteClarityProcess

  Delete a Clarity process. The creator or a team admin can delete it unless capture analysis is still in progress.

  shallow
• deleteClarityProcessInviteLink

  Delete the active interview invite link for a process.

  shallow
• deleteClarityProcessLabel

  Delete process tags from an organization.

  shallow
• deleteClarityProcessLink

  Delete a process-to-process link from the organization's Clarity landscape when the caller can manage both endpoint teams.

  shallow
• deleteClarityTeamInterview

  Delete a team-level Clarity interview

  shallow
• deleteConnection

  Delete a connection (disconnects the user's connection and removes any triggers bound to it).

  shallow
• deleteCredential

  Delete a login by id. Deleting a team-shared login requires manager role.

  shallow
• deleteCustomIntegration

  Delete a custom integration type (team-level catalog entry) and cascade-remove related connections. Requires manager-or-above role.

  shallow
• deleteEvalRubric

  Remove a single Agent-specific evaluation rubric. Future Runs on the build are no longer scored against it.

  shallow
• deleteFile

  Delete a file from team storage.

  shallow
• deletePulseDashboard

  Delete a Duvo Pulse dashboard. Only the creator can delete it.

  shallow
• deleteQueue

  Delete a queue. Interrupts all associated active runs first and returns the number of deleted cases plus the IDs of runs that were stopped.

  shallow
• deleteQueueLabel

  Delete a label from a queue. Cascade-deletes all assignments of this label on existing cases.

  shallow
• deleteReadNotifications

  Soft-delete all read notifications for the authenticated user's current team. Returns the count of notifications that were deleted. Destructive — only call on explicit user request. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

  shallow
• deleteSchedule

  Delete a schedule. Owners may delete their own schedules; team superadmins may delete any schedule on agents in the current team.

  shallow
• deleteSecret

  Soft-delete an env-var secret. Deleting a team-shared secret requires manager role.

  shallow
• deleteSkill

  Delete a skill for the current team.

  shallow
• deleteSkillRevision

  Delete a draft or historic skill revision and its files. The active revision can't be deleted — activate another revision first.

  shallow
• deleteSlackTrigger

  Permanently delete a Slack channel trigger you own. The agent stops starting Runs for that channel. To keep the trigger but stop it firing, update it with `enabled: false` instead.

  shallow
• deleteTeamInvite

  Revoke an 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.

  shallow
• deleteTeamInviteLink

  Delete the team's shareable invite link so the URL stops working. Per-person invitations are unaffected. Requires the Manager role or above.

  shallow
• detachPulseDashboardConnection

  Detach a connection (data source) from a Duvo Pulse dashboard (creator only).

  shallow
• detachRevisionLogin

  Detach a login from a revision. Personal logins can only be detached by their owner; team-shared logins require builder permissions.

  shallow
• detachRevisionSecret

  Detach an env-var secret from a revision. Personal secrets can only be detached by their owner; team-shared secrets require builder permissions.

  shallow
• dismissClarityCaptureSuggestion

  Dismiss a pending Process Landscape capture suggestion without creating a capture request (manager+).

  shallow
• dismissClarityTeamAssignmentSuggestion

  Dismiss a pending Process Landscape team-assignment suggestion without changing the node's owner (manager+).

  shallow
• dismissNotification

  Dismiss an important notification for the authenticated user, unpinning their own row from the Important section. 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.

  shallow
• downloadSkill

  Download a custom skill as a ZIP archive. Only custom (team-owned) skills can be downloaded.

  shallow
• duplicateAgent

  Duplicate an existing agent into a new agent named "Copy of <name>", carrying over its configuration. Use the include_* flags in the (optional) body to control what is copied; all default on except memory. Requires the Lead Builder team role or above.

  shallow
• duplicateClarityProcess

  Duplicate a Clarity process with its analysis, captures, message history, and, for v2 processes, its live current map and transformation proposal. Requires a team manager role.

  shallow
• duplicatePulseDashboard

  Duplicate a Duvo Pulse dashboard, producing an idle clone of the current rendered dashboard. The conversation history, shares, and connections are not copied.

  shallow
• exportPulseDashboardHtml

  Render a Duvo Pulse dashboard to a self-contained static HTML snapshot (text/html, data baked in). 404 until the first generation turn has produced HTML; 409 for an openui dashboard, whose substrate this exporter cannot render.

  shallow
• fileSuggestedClarityProcesses

  File every unfiled process the viewer can see into its suggested folder

  shallow
• finalizeCaseAttachment

  Confirm an uploaded case attachment against storage. Answers with the attachment in its settled state — `ready` when the bytes are present, `failed` (with a reason) when the upload never completed.

  shallow
• finalizeClarityOrganizationInterview

  Manually mark an in-progress organization interview as complete without requiring final media uploads

  shallow
• generateClarityPortfolioIntelligence

  Generate portfolio intelligence from all completed clarity processes. Returns 202 Accepted immediately and processes in background.

  shallow
• generateClarityProcessLandscape

  Start a process-landscape generation run for the organization from its eligible Clarity captures (organization executives and owners)

  shallow
• generateClarityProcessSnapshot

  Trigger a snapshot generation pipeline for a v2 clarity process, selected by kind. `current_process` runs the generateCurrentProcess pipeline (body fields are proposal-only and rejected); `transformation_proposal` runs the generate or regenerate proposal pipeline. Returns 202 immediately and finalises asynchronously via the cc-server webhook stream.

  shallow
• getAgent

  Get an agent by ID.

  shallow
• getAgentCaseTrigger

  Retrieve a single case trigger by id.

  shallow
• getAgentMemoryFile

  Get the contents of a single memory file for an agent.

  shallow
• getAgentSuggestion

  Fetch a single suggestion. Poll this after a 202 from consume: an AOP apply in flight reports payload.apply.state (running/failed); once consumed, applied_revision_id carries the draft revision the change was staged onto.

  shallow
• getBatchQueueStats

  Get case status counts for many Queues in ONE call. Use this after listQueues whenever you need per-Queue counts — cases waiting on a human, needing review, pending, failed — instead of calling listCases or searchCases once per Queue. 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.

  shallow
• getCase

  Get a case by ID. Returns the case, its event history, and every case-approval batch ever created on the case (newest first).

  shallow
• getCaseAttachmentDownloadUrl

  Mint a short-lived signed URL for one case attachment. `disposition=inline` serves the file for the in-app viewer; `attachment` forces a download.

  shallow
• getCaseQueueEvalRubrics

  List a queue's active case-level evaluation rubrics — the Pass/Fail questions a whole case is judged against at settlement. Shows the queue's current version's set (auto-generated from the connected Assignments' AOPs, plus any manually-authored rubrics).

  shallow
• getClarityArtifactChatMessages

  Load the latest artifact-chat messages for one active conversation, returned oldest-first.

  shallow
• getClarityCapture

  Get a single Clarity v2 capture including full transcript and video transcript. Use this when the process was loaded with captures=lite, or when only one capture's transcript is needed.

  shallow
• getClarityExport

  Get a Clarity export run by ID

  shallow
• getClarityHierarchyPeople

  List the people attached to every authorized linked process node in the organization's Process Landscape. Returns a flat list where each person carries `nodeId` and `processId`, plus their role, invite status, and capture count. `truncated` is true when the node subtree or any single process roster was capped.

  shallow
• getClarityOrganizationInterview

  Load a single organization Clarity interview with transcript

  shallow
• getClarityPortfolioIntelligence

  Get portfolio intelligence for the current team

  shallow
• getClarityProcess

  Get the v2 read model for a clarity process: the process row (with operational fields like generation_error, generation_progress, generation_started_at, generation_last_activity_at, custom_prompt), its captures, and the lightweight 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.

  shallow
• getClarityProcessInviteLink

  Get the active interview invite link for a process.

  shallow
• getClarityProcessJoinInfo

  Get information about a clarity interview invite link (public).

  shallow
• getClarityProcessLandscape

  Fetch the organization's full process landscape with process summaries, team assignments, and page-level stats

  shallow
• getClarityProcessSharing

  Get the sharing status for a clarity process

  shallow
• getClarityProcessSnapshot

  Fetch the full payload for a Clarity v2 process snapshot of either kind.

  shallow
• getClarityProcessTree

  Fetch the organization's process tree, or the subtree under rootId

  shallow
• getClarityTeamSettings

  Get clarity team settings for financial calculations

  shallow
• getConnection

  Get one of your connections by ID.

  shallow
• getConnectionCredentials

  Get the header keys configured for a connection. Sensitive values (api keys, tokens, passwords) are returned as empty strings — the response only reveals which credential fields are set, never their values.

  shallow
• getCredential

  Get a login by id. Returns the encrypted password/otp_secret blobs — only the owner or team members can access it.

  shallow
• getEvalRubrics

  List the evaluation rubrics a Run is scored against: the platform default rubrics plus the Agent-specific rubrics for a build. Defaults to the Agent's live build; pass build_id to target the revision a specific Run ran against.

  shallow
• getEvalScores

  Aggregate evaluation counts and flag distribution for an Assignment's Jobs since the given timestamp.

  shallow
• getFileContent

  Get the content of a text file.

  shallow
• getFileDownloadUrl

  Generate a signed download URL for a file.

  shallow
• getLegacyClarityProcess

  Get a legacy v1 Clarity process with process metadata, generated analysis, transformation guidance, generation progress, and captures. Use this for rows from listClarityProcesses where version=1; v2 rows should use getClarityProcess and snapshot detail tools.

  shallow
• getNotification

  Get a single notification by id for the authenticated user. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

  shallow
• getNotificationBatch

  Get a single notification batch by id for the authenticated user, with per-type live-member counts, unread count, and worst severity. Serves cold deep links and sidebar retention for batches the caller can no longer see in the feed. 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, or no live member matches the given filters.

  shallow
• getNotificationCounts

  Per-type notification counts for the authenticated user's current team. Narrow with `unread`, 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.

  shallow
• getNotificationFeed

  List the notification feed for the authenticated user's current team, most recent activity first. Each item is either an individual notification or a notification batch (a per-agent group of job_issue/eval_issue/job_done/schedule_issue 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.

  shallow
• getOrgInsightsHeadline

  Get org-wide headline insight KPIs (run totals, success rate, distinct active agents and users) aggregated across every team in the organization. Requires an organization Admin, Executive, or Owner role.

  shallow
• getOrgInsightsMetrics

  Get org-level insights metrics (runs, assignments, schedules) broken down per team across the organization. Requires an organization Admin, Executive, or Owner role.

  shallow
• getOrgInsightsUsageChart

  Get org-level run-volume buckets (scheduled vs on-demand) at day/week/month granularity across the organization. Requires an organization Admin, Executive, or Owner role.

  shallow
• getProfile

  Get the profile of the authenticated user (the owner of the API key).

  shallow
• getPulseDashboard

  Get a Duvo Pulse dashboard's metadata and generation status. When status is completed and html_code_present is true, fetch the rendered HTML from GET /artifacts/{artifactId}/render; the conversation is served by GET /artifacts/{artifactId}/messages.

  shallow
• getPulseDashboardAttachmentDownloadUrl

  Mint a short-lived presigned URL to download or preview a file attached to a Duvo Pulse dashboard message. Returns 404 once the dashboard's sandbox has expired and the file is gone (about 12 hours).

  shallow
• getPulseDashboardHtml

  Serve a Duvo Pulse dashboard's rendered HTML document (text/html, not JSON). 404 until the first generation turn has produced HTML.

  shallow
• getPulseDashboardPdf

  Render a Duvo Pulse dashboard to a PDF document (application/pdf, not JSON). 404 until the first generation turn has produced HTML; 409 for an openui dashboard, whose substrate this exporter cannot render.

  shallow
• getPulseDashboardVersionHtml

  Serve a specific version's rendered HTML document for a Duvo Pulse dashboard (text/html, requires edit access).

  shallow
• getQueue

  Get a queue by ID.

  shallow
• getRevision

  Get a revision by ID.

  shallow
• getRevisionCaseQueueSetup

  Check that this build's case-queue integration slots are wired up correctly. Returns, per case-queue-producer/consumer slot, how many queues are linked, plus whether your team owns any case queues. 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.

  shallow
• getRun

  Get information about an agent run. Can be polled to check status.

  shallow
• getRunEvaluation

  Get the latest evaluation analysis for a specific agent run (Run).

  shallow
• getSecret

  Get an env-var secret by id. Returns metadata and env var keys; secret values are never exposed.

  shallow
• getSkillFileContent

  Get the content of a file in a skill.

  shallow
• getSkillRevisionFileContent

  Get the content of a text file in a skill revision.

  shallow
• getTeam

  Get a team by ID. The caller must be scoped to the requested team.

  shallow
• getTeamInviteLink

  Get the team's shareable invite link — the one URL anyone can use to join the team, as opposed to a per-person invitation. Returns `hasLink: false` when no link has been created. Requires the Manager role or above.

  shallow
• getUnreadNotificationCount

  Get the unread notification count for the authenticated user's current team. 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.

  shallow
• initiateClarityPhoneInterview

  Initiate a phone call interview for a clarity process via ElevenLabs

  shallow
• inviteClarityMeetingNotetaker

  Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as a 'meeting' capture on the process

  shallow
• inviteClarityOrganizationNotetaker

  Invite the in-meeting notetaker bot (Recall.ai) to a live meeting; the recording lands as an organization Clarity interview

  shallow
• inviteOrgMember

  Invite a person to an organization you administer, optionally assigning them to a team in that organization. Requires an organization Admin, Executive, or Owner role. You cannot grant a role higher than your own.

  shallow
• listActiveClarityExports

  List active (queued or running) Clarity export jobs for the current user

  shallow
• listAgentCaseTriggers

  List the case triggers configured for an agent. Each trigger automatically dispatches the agent to run cases added to a queue.

  shallow
• listAgentFolders

  List all agent folders for the authenticated team.

  shallow
• listAgentMemoryFiles

  List the memory files stored for an agent.

  shallow
• listAgentRevisions

  List revisions for an agent.

  shallow
• listAgents

  List agents for your team.

  shallow
• listAgentSchedules

  List all schedules configured for an agent. Returns the schedules you own on this agent.

  shallow
• listAgentSlackBoundWorkspaces

  List the Slack workspaces bound to an agent build that you can create channel triggers for. Creating a Slack channel trigger for any other workspace is rejected, so start here to pick a valid `slack_team_id` and `integration_instance_id`.

  shallow
• listAgentSlackTriggers

  List the Slack channel triggers you own on an agent (Agent in the Duvo UI), oldest first. Each trigger's `filter_config` carries the watched `channelId`, `channelName`, Slack `workspaceId`, and `matchRule`. Capped at 100 triggers per agent.

  shallow
• listAgentSuggestions

  List an Agent's suggestions. status=pending is the inbox; status=history is consumed/dismissed/auto-cleared. Reads lazily auto-clear stale pending items.

  shallow
• listAgentTriggers

  List the trigger definitions the authenticated user owns on an agent (Agent in the Duvo UI). Triggers start a Run automatically when an external event fires (e.g. an email arrives or a Linear issue is created).

  shallow
• listAgentTriggerTypes

  List the trigger types available for an agent, grouped by integration. Use the returned `integration_slug` and `trigger_type` values when creating a trigger.

  shallow
• listAvailableClarityProcessLabels

  List process tags available for a process.

  shallow
• listCaseAttachments

  List the files attached to a case, oldest first. Includes attachments whose upload failed, so a missing source document is visible rather than silent.

  shallow
• listCaseLabels

  List all labels assigned to a case.

  shallow
• listCaseRunRecentMessages

  Return the latest qualifying messages (assistant text + tool calls) for a Run on a case, newest last. Used to populate the live body of an active Run card in the case Activity timeline.

  shallow
• listCaseRuns

  List Runs (agent runs) that have claimed or received handover of a case, newest first. Capped at 50 ownership events.

  shallow
• listCases

  List cases in a queue. Supports status, date-range, and free-text 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.

  shallow
• listClarityArtifactChatConversations

  List the current user's recent non-deleted artifact-chat conversations for a Clarity v2 process and snapshot kind.

  shallow
• listClarityExtraCaptureRequests

  List active extra-capture requests for a given transformation 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.

  shallow
• listClarityFolders

  List the team's process folders with process and suggestion counts

  shallow
• listClarityLandscapeCaptures

  List the organization's Process Landscape captures. By default, only captures eligible to seed new process proposals are returned; excluded captures can be included for inspection.

  shallow
• listClarityLandscapeNodeInterviews

  List Clarity interviews linked to a process folder

  shallow
• listClarityLandscapeNodePeople

  List the people involved in the process behind one process landscape node. To read the people across the whole landscape in one request, use getClarityHierarchyPeople instead.

  shallow
• listClarityOrganizationInterviews

  List Clarity interviews across an organization

  shallow
• listClarityProcessAssignedLabels

  List process tags on a process.

  shallow
• listClarityProcesses

  List Clarity processes for the current team, most recently updated first. Returns lightweight metadata (capture counts, contributors, status) suitable for building a picker; the per-process read model is available via `GET /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.

  shallow
• listClarityProcessLabels

  List process tags available in an organization.

  shallow
• listClarityProcessLinks

  List process-to-process links in the organization's Clarity landscape that are visible within the caller's team access scope. Use `node_id` to find links touching a specific process node.

  shallow
• listClarityProcessMembers

  List users with accepted access to a clarity process

  shallow
• listClarityProcessSnapshots

  List lightweight Clarity v2 process snapshots for one kind.

  shallow
• listClarityProcessSummaries

  Cross-process portfolio digest for every completed Clarity process on the team: per-process summary, SWOT, projected impact, and a step skeleton (role, system, and flow edges) — without step prose or source excerpts. Paginated (default 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.

  shallow
• listClarityTeamInterviews

  List team-level Clarity interviews

  shallow
• listConnections

  List the authenticated user's connections (connected integration instances) for the current team. Includes team-shared instances visible to the caller when the org-level Connections sharing setting is on. Filter by integration type with the `type` query parameter.

  shallow
• listCredentials

  List browser-login credentials visible to the caller for the current team — team-shared (user_id IS NULL) plus the caller's own personal logins. Optionally filter by `domain`. Passwords and OTP secrets are never returned; only metadata flags indicating whether they are set.

  shallow
• listFiles

  List files for the current team.

  shallow
• listIntegrations

  List the team's integration catalog: built-in integration types plus any custom connection types defined for the team. OAuth authorization flows are browser-based and cannot be performed via this API; use the Duvo dashboard to complete OAuth-based connections.

  shallow
• listMyOrganizations

  List the organizations the current user belongs to, with their role (organization:member, organization:admin, organization:owner, or organization:executive) and member count in each. Use this to check whether the user has an admin-or-above role before calling organization-scoped endpoints, which reject lower roles with 403.

  shallow
• listMyTeams

  List teams the authenticated caller can act on. Team-scoped API keys see only the key's team; user-scoped API keys and OAuth callers see every team they're a member of.

  shallow
• listNotifications

  List notifications for the authenticated user's current team, most recent first. Filter with type, unread, severity or minSeverity (mutually exclusive), important, agentRunId, or processId; paginate with limit/cursor. Pass batchId to 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.

  shallow
• listOrgTeams

  List teams belonging to an organization you are a member of, including your membership and role in each.

  shallow
• listPluginCatalog

  List plugins that can be referenced by name in a build's plugins array. Builds may also reference any public GitHub repository URL (https://github.com/owner/repo) as a plugin; those are not enumerated here.

  shallow
• listPulseDashboardConnections

  List the connections (data sources) attached to a Duvo Pulse dashboard (creator only).

  shallow
• listPulseDashboardMessages

  List the chat transcript of a Duvo Pulse dashboard's live version (requires edit access). Returns the most recent page by default, oldest first within the page; pass `before` (a message id from a previous page) to walk back through older messages. Messages from other version branches are not included.

  shallow
• listPulseDashboards

  List your Duvo Pulse dashboards (live, agent-generated visualizations of your Duvo data), most recently updated first.

  shallow
• listPulseDashboardVersions

  List the version history of a Duvo Pulse dashboard, newest first (requires edit access). Use the version id with the restore and version-render endpoints.

  shallow
• listQueueAgents

  List agents bound to a queue as producers (agents that push cases into the queue) or consumers (agents triggered by cases in the queue).

  shallow
• listQueueLabels

  List every label defined on a queue along with the count of cases each label is assigned to.

  shallow
• listQueues

  List queues for your team.

  shallow
• listRevisionIntegrationConnections

  List the connections you have pinned to this build's integration slot. Multi-pin is supported: you can pin multiple connections to the same slot.

  shallow
• listRevisionIntegrationQueues

  List the queues linked to this build's case-queue integration slot. Only meaningful for case-queue-producer and case-queue-consumer integrations.

  shallow
• listRevisionIntegrations

  List integrations attached to an agent revision.

  shallow
• listRevisionLogins

  List logins attached to a specific revision (build) of an assignment. Returns metadata only — passwords and OTP secrets are never exposed.

  shallow
• listRevisionSecrets

  List env-var secrets attached to a specific revision (build) of an assignment. Returns metadata and env-var keys only — secret values are never exposed.

  shallow
• listRunMessages

  Get paginated messages for an agent run. Messages are returned in chronological order.

  shallow
• listRuns

  List runs for the current team. Supports filtering by agent, user, queue, status, etc. Messages, evaluation data, and queue metadata are included where available. Set count_only=true to skip Run row selection and enrichment. The normal response shape is returned with data: [] and the matching total.

  shallow
• listSandboxFiles

  List files in a sandbox directory.

  shallow
• listSecrets

  List env-var secrets visible to the caller — team-shared (user_id IS NULL) plus the caller's own personal entries. Returns metadata and env-var keys only; secret values are never exposed.

  shallow
• listSkillAssignments

  List the agents in the current team whose live build references the given skill. Used to warn users that editing a skill will affect every agent that uses it.

  shallow
• listSkillFiles

  List all files in a skill.

  shallow
• listSkillRevisionFiles

  List the files in a skill revision, one page at a time. When `has_more` is true, pass `next_cursor` back as `cursor` to fetch the next page.

  shallow
• listSkillRevisions

  List a skill's version history. Each revision is a snapshot of the skill's files; at most one is active (live) at a time, plus at most one open draft.

  shallow
• listSkills

  List all skills for the current team, including system skills.

  shallow
• listSystemSkills

  List all system skills (skills available to all teams).

  shallow
• listTeamInvites

  List a team's pending invitations — everyone invited who has not yet accepted or declined. Pass `processId` to list the pending invitations for a single Clarity process instead.

  shallow
• listTeamMembers

  List members of a team. The authenticated session or API key must be scoped to the requested team.

  shallow
• markAllNotificationsRead

  Mark all notifications as read for the authenticated user's current team. Returns the count of notifications that were updated. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

  shallow
• markNotificationBatchRead

  Mark every unread live member of a notification batch as read for the authenticated user. Pass `types` to narrow the mark-read to those member types, and `severity` (exact) or `minSeverity` (threshold, mutually exclusive with `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. 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.

  shallow
• markNotificationRead

  Mark a notification as read for the authenticated user. Idempotent — calling it again on an already-read notification still returns success. Requires the Notification Center feature; returns 404 when it is not enabled for the team.

  shallow
• moveAgent

  Move an agent (and its connected workspace) to a different team. Pass dry_run=true to preview the closure without applying changes.

  shallow
• moveAgentsToFolder

  Move one or more agents (assignments) into a folder, or to the root level.

  shallow
• moveClarityProcessesToFolder

  Move processes into a folder (or back to Unfiled)

  shallow
• movePulseDashboard

  Move a Pulse dashboard from the team in the URL to another team, keeping only its latest revision (chat history and older revisions are deleted). The caller must be a Manager or above on both teams. Pass dryRun=true to preview which Connections reconnect vs drop without applying changes.

  shallow
• organizeClarityProcessLandscape

  Start an asynchronous organization pass over the organization's unfiled processes, placing them into the Process Landscape where possible (organization admin+). Results appear progressively; started is false when there is nothing to organize.

  shallow
• pinRevisionIntegrationConnection

  Pin one of your connections (from GET /v2/teams/:team_id/connections) to this build's integration slot. Multi-pin is supported: a single user can pin multiple connections to the same slot.

  shallow
• postprocessClaritySnapshot

  Re-run postprocessing agents on an existing v2 clarity snapshot. Targets either the current-process snapshot or the transformation-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.

  shallow
• postRunMessage

  Post a message to an agent run. This will persist the message and resume the agent execution if the run is in a resumable state (waiting, completed, or interrupted).

  shallow
• previewAgentCaseTriggerConflicts

  Preview which other agents would conflict with this agent's case trigger if it pointed at the given queue. Does not modify the trigger.

  shallow
• probeMcpServer

  Probe an MCP server URL and list the tools it exposes. Useful as a dry-run before creating a connection — verifies the URL is reachable, that authentication headers (if any) are correct, and surfaces the tool catalog. Performs no writes; sits alongside `/v2/teams/:team_id/connections/oauth/mcp/check` (which probes the same URL for OAuth support).

  shallow
• promoteClarityProcessSnapshot

  Promote a draft or historic Clarity v2 snapshot to live for its kind.

  shallow
• promoteRevision

  Promote a draft or historic revision to the live version. The live revision is the one used by triggers and new runs. Fails if the revision is already live, or if a draft revision still has an active builder run.

  shallow
• promoteSkillRevision

  Make a skill revision the active (live) one. The previously active revision becomes historic and can be re-activated later. Idempotent: promoting the already-active revision succeeds rather than erroring, and still applies any revision_name / revision_description supplied in the body.

  shallow
• proposeClarityLandscapeProcess

  Create a manual process in the organization's Process Landscape, either as an unassigned proposal or atomically assigned to an eligible team.

  shallow
• publishPulseDashboard

  Publish (share) a Duvo Pulse dashboard to your whole team or your whole organization, or revert it to private (creator only). When publishing, set permission to 'view' (teammates see the dashboard) or 'edit' (teammates can also iterate on it); organization-wide viewers outside the team always get view-only access.

  shallow
• refreshPulseDashboard

  Trigger an on-demand data refresh of a Duvo Pulse dashboard. The dashboard regenerates its connection-sourced values in the background — poll GET /artifacts/{artifactId} for status.

  shallow
• rejectAgentSuggestion

  Dismiss a pending suggestion.

  shallow
• removeClarityLandscapeNodePerson

  Remove a person from the process behind a process landscape node, and revoke the process access they were granted when they were added.

  shallow
• removeClarityProcessMember

  Remove accepted access to a clarity process

  shallow
• removeRevisionIntegration

  Remove an integration from an agent revision. Removes the slot for everyone on the revision, including all per-user connection pins. Requires edit permission on the agent.

  shallow
• removeTeamMember

  Remove a member from a team. Removing another member requires the Superadmin role or above; any member may remove themselves (leaving the team). The last remaining Owner cannot be removed, and a member whose Owner role is inherited from the organization can only leave voluntarily.

  shallow
• renameFile

  Rename a file in team storage.

  shallow
• reorderClarityFolders

  Reorder the team's process folders to match the given id order. The payload must name every folder exactly once.

  shallow
• reorderClarityLandscapeAreas

  Reorder a sibling group of the organization's process landscape area folders left-to-right — the top-level areas by default, or the folder children of parentId (organization admin+). This changes display order only; use setClarityLandscapeNodePlacement to move a node to a different parent.

  shallow
• replaceCaseQueueEvalRubrics

  Replace the entire case-level evaluation rubric set on a queue's current version (1 to 12 rubrics). 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.

  shallow
• replaceEvalRubrics

  Replace a build's entire Agent-specific evaluation rubric set in one call (at most 5 rubrics). 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.

  shallow
• replaceRevisionIntegrationQueues

  Replace the set of queues linked to this build's case-queue integration slot. Send the full desired queue list — any queues not in the list will be unlinked. Requires edit permission on the agent. After linking, call getRevisionCaseQueueSetup to confirm the slot now reports linked_queue_count > 0.

  shallow
• respondToHumanRequest

  Respond to a human-in-the-loop request. Use 'approved' (true/false) for approval-type requests, or 'answers' ({question: answer}) for question-type requests. Only works when the run is in 'waiting' status.

  shallow
• restorePulseDashboardVersion

  Restore a previous version of a Duvo Pulse dashboard, making it live again (requires edit access). Non-destructive — it moves the head pointer to the chosen version.

  shallow
• revertClarityProcessSnapshot

  Archive a Clarity v2 snapshot of either kind. If the live row is archived, the repository auto-promotes the latest historic row of the same kind.

  shallow
• saveClarityProcessSnapshot

  Save user edits as the live Clarity v2 snapshot for the selected kind.

  shallow
• searchCases

  Search cases in a queue with rich filters (multi-status, date ranges, label-based filters). Use this when the simple query-string filters on GET /v2/queues/:queue_id/cases aren't enough. Set count_only=true to skip Case row selection, enrichment, and transformation. The normal response shape is returned with cases: [] and the matching total.

  shallow
• sendPulseDashboardMessage

  Send an instruction to iterate on a Duvo Pulse dashboard (e.g. 'make it a bar chart', 'filter to last 14 days'). The creator can always iterate; teammates can too when the Pulse is published to the team with edit access. The agent regenerates asynchronously — poll GET /artifacts/{artifactId} for status.

  shallow
• sendTeamInviteEmail

  Email an invitation to its recipient. Use this to deliver an invitation created by createTeamInvite (which never sends mail on its own), or to resend one the recipient never received. The accept link is always built from the server-configured app origin.

  shallow
• setClarityLandscapeNodePlacement

  Move a process landscape node (team manager or above for team processes; organization admin for areas)

  shallow
• setClarityLandscapePriorities

  Set or clear heatmap priorities in one batch (team managers for their processes; organization admin+ across the organization)

  shallow
• setupClarityFoldersFromLandscape

  Create one linked folder per landscape group node containing this team's processes. Idempotent: groups that already have a linked folder are skipped.

  shallow
• startClarityExport

  Start a Clarity → SAP Signavio export job

  shallow
• startNativeOAuth

  Start an OAuth-based connection with a native provider (Gmail, Google Sheets, Outlook, etc.). 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.

  shallow
• startRun

  Start a new agent run. Returns immediately with run info - does not wait for completion.

  shallow
• stopClarityArtifactChatConversation

  Stop an in-flight artifact-chat turn. Flips the conversation back to `open` first so the interrupted run's late webhooks are dropped as stale, then best-effort interrupts the cc-server execution.

  shallow
• stopClarityProcessSnapshot

  Stop an in-flight snapshot generation for the selected kind. Reads the sandbox id from the process row, kills the sandbox, flips the process back to `review`, and clears the sandbox marker so any late webhook from the killed run is dropped as stale.

  shallow
• stopPulseDashboardMessage

  Stop an in-flight Duvo Pulse generation turn. Requires edit access to the dashboard. Flips the dashboard to 'interrupted' and keeps any streamed-so-far reply; stopping when nothing is generating is a successful no-op.

  shallow
• stopRun

  Stop an agent run. No-op if the run is not currently running.

  shallow
• unlinkCaseLabels

  Remove the given labels from a case.

  shallow
• unlinkClarityProcessLabels

  Remove process tags from a process.

  shallow
• unpinRevisionIntegrationConnection

  Unpin one of your connections from this build's integration slot. The connection itself is not deleted; only the binding to this slot is removed.

  shallow
• updateAgent

  Update an agent's display name or delivery settings.

  shallow
• updateAgentCaseTrigger

  Update fields on a case trigger. Only the trigger creator or a builder/admin can disable an enabled trigger or change its queue, and only a builder/admin can change queue concurrency.

  shallow
• updateAgentFolder

  Rename an agent folder or move it to a new parent.

  shallow
• updateCase

  Edit a case's title and/or its free-form data payload. Provide at least one field. 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.

  shallow
• updateCaseQueueEvalRubric

  Edit a single case-level evaluation rubric's title and/or description. The edit produces a NEW rubric (with a new id and slug) so previously judged cases stay attributed to the original criterion; the response contains the new rubric.

  shallow
• updateClarityFolder

  Rename a process folder. Renaming a landscape-linked folder permanently stops landscape name-sync.

  shallow
• updateClarityGuidance

  Update the transformation guidance message for a clarity process

  shallow
• updateClarityLandscapeNode

  Rename a process landscape node or update its owner label (team manager or above for team processes; organization admin for areas)

  shallow
• updateClarityLandscapeNodePerson

  Change the role a person plays in the process behind a process landscape node (for example "Approver"). Send role: null to clear it.

  shallow
• updateClarityOrganizationInterview

  Rename an organization landscape Clarity capture

  shallow
• updateClarityProcess

  Update a Clarity process name, guidance, visibility, or completion status. Team Builders can edit names and guidance, only the creator or a team manager can change visibility, and completion requires a manager role.

  shallow
• updateClarityProcessLabel

  Update process tags for an organization.

  shallow
• updateClarityProcessLink

  Update a process-to-process link in the organization's Clarity landscape when the caller can manage both endpoint teams.

  shallow
• updateClarityProcessSharing

  Enable or disable sharing for a clarity process

  shallow
• updateClarityTeamSettings

  Update clarity team settings for financial calculations

  shallow
• updateConnection

  Update an existing connection. For sensitive header values, sending an empty string keeps the existing value; send a new value to overwrite. Toggling `shared` moves the connection between personal and team-shared.

  shallow
• updateCredential

  Update a login by id. At least one of password or otp_secret must remain set after the update. Editing a team-shared login or toggling sharing requires manager role.

  shallow
• updateEvalRubric

  Edit a single Agent-specific evaluation rubric's title and/or description. The edit produces a NEW rubric (with a new id and slug) so previously scored Runs stay attributed to the original criterion; the response contains the new rubric.

  shallow
• updateFileContent

  Update the content of a text file.

  shallow
• updatePulseDashboard

  Update a Duvo Pulse dashboard's settings — rename it. Only the creator can update it.

  shallow
• updateQueue

  Update a queue.

  shallow
• updateQueueLabel

  Update a label's key, value, or color. Renaming key/value affects every case assigned to this label.

  shallow
• updateRevision

  Update a revision's configuration, name, description, or handover targets. Returns the updated revision.

  shallow
• updateSchedule

  Update fields on an existing schedule. Only supplied fields are changed; omitted fields retain their current values. Owners may update their own schedules; team superadmins may update any schedule on agents in the current team.

  shallow
• updateSecret

  Update an env-var secret. Send `values` to replace all entries, or any of `rename_keys`, `remove_keys`, `add_values` for a non-destructive patch. Editing a team-shared secret or toggling sharing requires manager role.

  shallow
• updateSkillFile

  Update the content of a file in a skill, overwriting the active revision in place — the previous content is not recoverable. Prefer the non-destructive flow when you can: createSkillRevision to open a draft, updateSkillRevisionFile to edit it, promoteSkillRevision to activate it. Only team skills can be edited.

  shallow
• updateSkillRevision

  Rename a skill revision or change its description. Works for drafts, the active revision, and historic revisions.

  shallow
• updateSkillRevisionFile

  Write a text file into a skill revision. Writing into a draft leaves the active revision untouched until the draft is promoted; writing into the active revision changes what the skill runs immediately. Historic revisions are read-only: create a draft from one to edit it.

  shallow
• updateSlackTrigger

  Update a Slack channel trigger you own — repoint it at another channel, change which messages match, or pause and resume it with `enabled`. Only the supplied fields change. Resuming a paused trigger requires the Slack connection it runs off to still be available on the agent; changing the channel resets the trigger's seen-message state.

  shallow
• updateTeamInvite

  Change the role on a pending team invitation. Only pending invitations can be updated — one already accepted or declined is rejected. Requires the Manager role or above on the invitation's own team.

  shallow
• updateTeamMemberRole

  Update an existing team member's role. Requires the Manager role or above; only an Owner may grant or remove the Owner role, and the last remaining Owner cannot be demoted. A member whose Owner role is inherited from the organization cannot be changed here.

  shallow
• upgradeClarityProcess

  Move a v1 clarity process into v2. Rows with generated analysis are reset in place and regenerated; rows without analysis migrate in place when not generating.

  shallow
• uploadSandboxFile

  Upload a file directly to the sandbox. Maximum file size is 10MB. For larger files, use POST /v2/sandboxes/:sandbox_id/upload-urls.

  shallow
• upsertAgentTrigger

  Create or update the authenticated user's trigger for an integration on an agent. The integration must already be connected to the agent (its OAuth connection set up in the Duvo dashboard). Set `enabled: false` to pause a trigger without deleting it.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/245ce5d3-ff3c-4348-91cd-065e9714a596/badge.svg)](https://vouch.tools/servers/245ce5d3-ff3c-4348-91cd-065e9714a596)