operationId values — camelCase, stable identifiers. Renaming a value is a breaking change, so names only change in major releases.
New Public API endpoints automatically become MCP tools on the next deploy. There is no separate registration step.
Assignments
| Tool | Description |
|---|---|
listAgents | List Assignments for your team. |
createAgent | Create a new Assignment. |
getAgent | Get an Assignment by ID. |
updateAgent | Update an Assignment’s display name or delivery settings. |
deleteAgent | Delete an Assignment. Active Jobs are interrupted, and its schedules and Case Triggers are removed. |
Assignment Folders
| Tool | Description |
|---|---|
listAgentFolders | List folders for organizing Assignments. |
createAgentFolder | Create a new folder. |
updateAgentFolder | Rename or update a folder. |
deleteAgentFolder | Delete a folder. |
moveAgentsToFolder | Move one or more Assignments into a folder. |
Setups
A Setup is a versioned configuration of an Assignment — its SOP, Connections, and other settings.| Tool | Description |
|---|---|
listAgentRevisions | List Setups for an Assignment. |
getRevision | Get a Setup by ID. |
createRevision | Create a new Setup for an existing Assignment. |
updateRevision | Update a Setup’s name or SOP. |
promoteRevision | Promote a Setup to active, making it the one used for new Jobs. |
Jobs
| Tool | Description |
|---|---|
listRuns | List Jobs for your team. |
startRun | Start a new Job on an Assignment. |
getRun | Get a Job’s current status and details. |
listRunMessages | List all messages exchanged during a Job. |
postRunMessage | Send a message to an active Job. |
respondToHumanRequest | Respond to a human-in-the-loop request from an active Job. |
stopRun | Stop an active Job. |
Assignment Memory
| Tool | Description |
|---|---|
listAgentMemoryFiles | List the memory files an Assignment has saved. |
getAgentMemoryFile | Get the contents of a single Assignment memory file. |
Files
| Tool | Description |
|---|---|
listFiles | List Files for your team. |
createFileUploadUrl | Generate a signed URL to upload a new file to team storage. |
getFileContent | Get the text content of a file. |
updateFileContent | Update the text content of a file. |
getFileDownloadUrl | Generate a signed download URL for a file. |
renameFile | Rename a file. |
deleteFile | Delete a file from team storage. |
Cases and Queues
Cases are individual work items routed through an Assignment. Queues group related cases.| Tool | Description |
|---|---|
listQueues | List case queues for your team. |
createQueue | Create a new case queue. |
getQueue | Get a queue by ID. |
updateQueue | Update a queue’s name or settings. |
deleteQueue | Delete a queue. |
listQueueAgents | List Assignments attached to a queue. |
listCases | List cases in a queue. |
searchCases | Search for cases across queues. |
getCase | Get a case by ID. |
createCases | Create new cases in a queue. |
deleteCase | Delete a case. |
bulkReprocessCases | Re-process a batch of cases on a chosen Assignment. |
bulkUpdateCaseStatus | Update the status of multiple cases at once. |
listCaseRuns | List Jobs for a specific case. |
listCaseRunRecentMessages | Get recent messages from the latest Job on a case. |
Case Labels
| Tool | Description |
|---|---|
listQueueLabels | List labels defined in a queue. |
createQueueLabel | Create a new label in a queue. |
updateQueueLabel | Update a queue label’s name or color. |
deleteQueueLabel | Delete a queue label. |
listCaseLabels | List labels currently assigned to a case. |
assignCaseLabels | Assign one or more labels to a case. |
unlinkCaseLabels | Remove labels from a case. |
Case Triggers
Case triggers automatically route new cases to a queue based on matching rules.| Tool | Description |
|---|---|
listAgentCaseTriggers | List case triggers for an Assignment. |
createAgentCaseTrigger | Create a new case trigger. |
getAgentCaseTrigger | Get a case trigger by ID. |
updateAgentCaseTrigger | Update a case trigger’s rules or settings. |
deleteAgentCaseTrigger | Delete a case trigger. |
previewAgentCaseTriggerConflicts | Preview conflicts before saving a case trigger. |
Triggers
Event triggers start a Job automatically when an external event fires (for example, an email arrives, a Linear issue is created, or a file changes in Google Drive).| Tool | Description |
|---|---|
listAgentTriggers | List the event triggers you own for an Assignment. |
upsertAgentTrigger | Create or update an event trigger for an Assignment. |
listAgentTriggerTypes | List the available trigger types for an Assignment by Connection. |
Connections
| Tool | Description |
|---|---|
listIntegrations | List available connection types for your team. |
listConnections | List your team’s authorized Connections. |
getConnection | Get a Connection by ID. |
createConnection | Create a new Connection. |
updateConnection | Update a Connection’s settings. |
deleteConnection | Remove a Connection. |
getConnectionCredentials | Get credentials for a Connection. |
createCustomIntegration | Register a custom MCP server as a Connection type. |
deleteCustomIntegration | Remove a custom MCP server Connection type. |
probeMcpServer | Test connectivity to an MCP server URL. |
startNativeOAuth | Start an OAuth flow for a native provider (Gmail, Google Sheets, Outlook, etc.) and return an authorization URL. |
startComposioConnection | Start a Composio OAuth flow and return an authorization URL. |
connectComposioIntegration | Finalize a Composio-backed connection after completing the OAuth start step. |
authorizeMcpOAuth | Start an OAuth flow for a remote MCP server using Dynamic Client Registration and return an authorization URL. |
checkMcpOAuth | Probe an MCP server URL to discover whether it supports OAuth Dynamic Client Registration. |
listPluginCatalog | List built-in plugins that can be referenced by name in a Setup’s plugins array. |
Skills
| Tool | Description |
|---|---|
listSkills | List Skills for your team. |
listSystemSkills | List system-wide Skills available to all teams. |
createSkill | Create a new Skill. |
listSkillFiles | List files in a Skill. |
getSkillFileContent | Get the content of a Skill file. |
updateSkillFile | Update the content of a Skill file. |
downloadSkill | Download a Skill as an archive. |
deleteSkill | Delete a Skill. |
listSkillAssignments | List Assignments that use a Skill. |
Schedules
| Tool | Description |
|---|---|
listAgentSchedules | List schedules configured for an Assignment. |
createSchedule | Create a schedule for an Assignment. |
updateSchedule | Update an existing schedule. |
deleteSchedule | Delete a schedule. |
Secrets and Logins
| Tool | Description |
|---|---|
listSecrets | List stored secrets for your team. |
createSecret | Create a new stored secret. |
getSecret | Get a secret by ID. |
updateSecret | Update a secret. |
deleteSecret | Delete a secret. |
listCredentials | List stored Logins for your team. |
createCredential | Create a new Login. |
getCredential | Get a Login by ID. |
updateCredential | Update a Login. |
deleteCredential | Delete a Login. |
Setup Configuration
These tools attach Connections, Logins, and Secrets to a specific Setup.| Tool | Description |
|---|---|
listRevisionIntegrations | List Connections attached to a Setup. |
attachRevisionIntegrations | Attach one or more Connections to a Setup. |
removeRevisionIntegration | Remove a Connection from a Setup. |
listRevisionIntegrationConnections | List Connection instances for an integration slot on a Setup. |
pinRevisionIntegrationConnection | Pin a specific Connection to an integration slot on a Setup. |
unpinRevisionIntegrationConnection | Unpin a Connection from an integration slot on a Setup. |
listRevisionIntegrationQueues | List queues configured for an integration slot on a Setup. |
replaceRevisionIntegrationQueues | Replace the queues configured for an integration slot on a Setup. |
getRevisionCaseQueueSetup | Check that a Setup’s case-queue slots each point at a queue. |
listRevisionLogins | List Logins attached to a Setup. |
attachRevisionLogin | Attach a Login to a Setup. |
detachRevisionLogin | Remove a Login from a Setup. |
listRevisionSecrets | List Secrets attached to a Setup. |
attachRevisionSecret | Attach a Secret to a Setup. |
detachRevisionSecret | Remove a Secret from a Setup. |
Sandboxes
| Tool | Description |
|---|---|
createSandbox | Create a new sandbox environment. |
createSandboxUploadUrl | Generate a signed URL to upload files to a sandbox. |
listSandboxFiles | List files in a sandbox directory. |
uploadSandboxFile | Upload a file directly to a sandbox. |
Team
| Tool | Description |
|---|---|
listMyTeams | List teams the authenticated caller can act on. |
getTeam | Get your team’s details. |
listTeamMembers | List members of your team. |
getProfile | Get your user profile. |
Process Intelligence
| Tool | Description |
|---|---|
listClarityProcesses | List process captures for your team. |
getClarityProcess | Get a process capture by ID. |
getLegacyClarityProcess | Get a legacy process capture by ID. |
listClarityExtraCaptureRequests | List pending extra capture requests for a process. |
getClarityCurrentProcessSnapshot | Get a snapshot of the current process. |
getClarityTransformationProposalSnapshot | Get a snapshot of a transformation proposal. |
Related
- Connect to the Duvo MCP server — set up a host before calling these tools
- Public API Reference — exact request and response shapes for each tool