Duvo AI

https://docs.duvo.ai
Admin
Duvo AI is an enterprise automation platform that enables users to build AI-powered agents and...
Tokens:486,731
Snippets:3,097
Trust Score:6.8
Update:2 months ago
Show doc for...
Tokens:
Raw
### GET /plugins/catalog

Source: https://docs.duvo.ai/api-reference

List built-in plugins that can be referenced in a Setup.

```APIDOC
## GET /plugins/catalog

### Description
List built-in plugins that can be referenced in a Setup.

### Method
GET

### Endpoint
/plugins/catalog
```

--------------------------------

### Browse and install Skills

Source: https://docs.duvo.ai/cli/managing-files-and-skills

Commands to list available Skills and install them into the team library.

```bash
duvo skills list                                # list Skills available to your team
duvo skills list --system                       # restrict the list to system Skills
duvo skills system                              # list global system Skills available to all teams
duvo skills install <skill-id>                  # copy a system (or any accessible) Skill into your team's library
duvo skills agents <skill-id>              # list Agents whose live Setup references a Skill
```

--------------------------------

### Install Duvo CLI

Source: https://docs.duvo.ai/cli/index

Installation methods for macOS, Linux, and Windows environments.

```bash
curl -fsSL https://duvo.ai/install-cli.sh | bash
```

```bash
npm install -g @duvoai/cli
```

```bash
curl -fsSL https://duvo.ai/install-cli.sh | sh
```

--------------------------------

### GET /agents/{agent_id}/revisions/{build_id}/integrations

Source: https://docs.duvo.ai/api-reference

List Connections attached to a Setup.

```APIDOC
## GET /agents/{agent_id}/revisions/{build_id}/integrations

### Description
List Connections attached to a Setup.

### Method
GET

### Endpoint
/agents/{agent_id}/revisions/{build_id}/integrations
```

--------------------------------

### GET /agents/{agentId}/revisions/{buildId}/logins

Source: https://docs.duvo.ai/api-reference

List Logins attached to a Setup.

```APIDOC
## GET /agents/{agentId}/revisions/{buildId}/logins

### Description
List Logins attached to a Setup.

### Method
GET

### Endpoint
/agents/{agentId}/revisions/{buildId}/logins
```

--------------------------------

### Install and initialize Duvo CLI

Source: https://docs.duvo.ai/cli/index

Installation methods for macOS/Linux and Node.js environments, followed by basic command usage.

```bash
# 1. Install
curl -fsSL https://duvo.ai/install-cli.sh | bash

# 2. Sign in (opens your browser)
duvo login

# 3. List your Agents
duvo agents list

# 4. Start a Run
duvo runs start --agent <agent-id>

# 5. Check Run status
duvo runs get <run-id>
```

```bash
# 1. Install (requires Node.js 24+)
npm install -g @duvoai/cli

# 2. Sign in (opens your browser)
duvo login

# 3. List your Agents
duvo agents list

# 4. Start a Run
duvo runs start --agent <agent-id>

# 5. Check Run status
duvo runs get <run-id>
```

--------------------------------

### Setup Configuration Tools

Source: https://docs.duvo.ai/mcp/available-tools

Tools for attaching connections, logins, and secrets to specific setups.

```APIDOC
## Setup Configuration Tools

- `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.
```

--------------------------------

### Setup Management Tools

Source: https://docs.duvo.ai/mcp/available-tools

Tools for managing agent versions and configurations (Setups).

```APIDOC
## MCP Tools: Setups

- `listAgentRevisions`: List Setups for an Agent.
- `getRevision`: Get a Setup by ID.
- `createRevision`: Create a new Setup for an existing Agent.
- `updateRevision`: Update a Setup's name or AOP.
- `promoteRevision`: Promote a Setup to active.
```

--------------------------------

### Verify Installation

Source: https://docs.duvo.ai/cli/index

Commands to check the installed version and view available CLI options.

```bash
duvo --version
```

```bash
duvo --help
```

--------------------------------

### Example Response Formatting

Source: https://docs.duvo.ai/user-guide/skills/creating-custom-skills

Demonstrates how to present concrete examples of good interactions within a skill.

```markdown
## Example: Responding to a Late Delivery Complaint

**Customer message:**
"My order was supposed to arrive yesterday and it still hasn't come!"

**Good response:**
"I'm sorry to hear your order hasn't arrived yet. That's frustrating,
and I want to help resolve this. Let me look up your order status right now.

Could you please provide your order number? I'll track it down and
get you an update within the hour."
```

--------------------------------

### Install the Duvo CLI

Source: https://docs.duvo.ai/cli/index

Installs the Duvo CLI using either a shell script or npm.

```bash
curl -fsSL https://duvo.ai/install-cli.sh | bash
```

```bash
npm install -g @duvoai/cli         # requires Node.js 24+
```

--------------------------------

### GET /agents/{agent_id}/revisions

Source: https://docs.duvo.ai/api-reference

Lists all setups (revisions) for a specific agent.

```APIDOC
## GET /agents/{agent_id}/revisions

### Description
List Setups for an Agent.

### Method
GET

### Endpoint
/agents/{agent_id}/revisions

### Parameters
#### Path Parameters
- **agent_id** (string) - Required - The unique identifier of the agent.
```

--------------------------------

### GET /agents/{agentId}/revisions/{buildId}/credentials

Source: https://docs.duvo.ai/api-reference

List Secrets attached to a Setup.

```APIDOC
## GET /agents/{agentId}/revisions/{buildId}/credentials

### Description
List Secrets attached to a Setup.

### Method
GET

### Endpoint
/agents/{agentId}/revisions/{buildId}/credentials
```

--------------------------------

### List available plugins

Source: https://docs.duvo.ai/cli/managing-files-and-skills

Displays all plugins available for reference in an Agent's Setup, with an option to output in JSON format.

```bash
duvo plugins list                               # browse every plugin you can reference in a Setup
duvo plugins list --json
```

--------------------------------

### Clarity CLI Quick Start Commands

Source: https://docs.duvo.ai/cli/clarity

Common commands for searching, inspecting, and managing Clarity processes via the terminal.

```bash
duvo clarity search "invoice" --limit 5
duvo clarity overview <process-id>
duvo clarity versions <process-id>
duvo clarity compare <process-id>
duvo clarity gaps <process-id>
duvo clarity evidence <process-id>
duvo clarity import-artifact <process-id> miro-export.svg
duvo clarity create-invite-link <process-id>
duvo clarity export <process-id> > clarity-brief.md
```

--------------------------------

### GET /agents/{agent_id}/revisions/{build_id}

Source: https://docs.duvo.ai/api-reference

Retrieves a specific setup revision by ID.

```APIDOC
## GET /agents/{agent_id}/revisions/{build_id}

### Description
Get a Setup by ID.

### Method
GET

### Endpoint
/agents/{agent_id}/revisions/{build_id}

### Parameters
#### Path Parameters
- **agent_id** (string) - Required - The unique identifier of the agent.
- **build_id** (string) - Required - The unique identifier of the build/revision.
```

--------------------------------

### Check environment and tools

Source: https://docs.duvo.ai/cli/clarity

Use these commands to verify authentication, API connectivity, and view the available tool map.

```bash
duvo clarity doctor
duvo clarity doctor <process-id>
duvo clarity tools
```

--------------------------------

### Retrieve Run Execution Details

Source: https://docs.duvo.ai/user-guide/security/audit-log

Example JSON response structure returned by the GET /runs/{run_id} endpoint.

```json
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "assignment_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "assignment_name": "Invoice Processing",
  "status": "completed",
  "trigger": "schedule",
  "created_by": "user@example.com",
  "started_at": "2026-05-18T09:00:00.000Z",
  "completed_at": "2026-05-18T09:03:42.000Z",
  "duration_seconds": 222
}
```

--------------------------------

### OpenAPI Specification for Get Revision Case Queue Setup

Source: https://docs.duvo.ai/api-reference/revision-integrations/get-revision-case-queue-setup

The OpenAPI definition for the getRevisionCaseQueueSetup operation, detailing the path parameters and endpoint configuration.

```yaml
openapi: 3.0.3
info:
  title: Duvo Public API
  description: >-
    Public API for programmatic access to Duvo. Authenticate with API keys
    created in the Duvo dashboard.
  version: 1.0.0
servers:
  - url: https://api.duvo.ai
    description: Production server
security: []
tags:
  - name: Runs
    description: Start, monitor, and manage agent runs (Runs in the Duvo UI)
  - name: Sandboxes
    description: Create sandboxes and upload files for agent runs
  - name: Queues
    description: Manage queues and their agent bindings
  - name: Cases
    description: Create, list, and manage cases and their labels within queues
  - name: Case Approvals
    description: Submit decisions on pending case approval requests issued by an agent run
  - name: Agents
    description: Create and manage agents for automation workloads
  - name: Revisions
    description: Create and manage agent revisions — the underlying Setup for an Agent
  - name: Agent Folders
    description: Organize agents into folders
  - name: Agent Memory
    description: Read an agent's memory files (the Memory feature in the Duvo UI)
  - name: Suggestions
    description: >-
      List, apply, and dismiss an Agent's improvement suggestions (the
      suggestions inbox in the Duvo UI)
  - name: Notifications
    description: >-
      List, read, dismiss, and clear the authenticated user's team notifications
      (the Notification Center in the Duvo UI)
  - name: Schedules
    description: List schedules configured for an agent
  - name: Duvo Pulse
    description: >-
      Create, list, iterate on, and delete Duvo Pulse dashboards — live,
      agent-generated visualizations of your Duvo data
  - name: Case Triggers
    description: >-
      Configure case triggers that automatically dispatch agent runs (Runs in
      the Duvo UI) for cases added to a queue
  - name: Triggers
    description: >-
      Configure event triggers that start a Run automatically when an external
      event fires (e.g. an email arrives, a Linear issue is created, or a file
      changes in Google Drive)
  - name: Skills
    description: Manage team and system skills (reusable knowledge packs).
  - name: Files
    description: Manage team files.
  - name: Plugins
    description: Discover plugins that can be referenced from a revision.
  - name: Organizations
    description: Inspect organizations you belong to and the teams within them
  - name: Team
    description: Inspect the team and members associated with the API key
  - name: Integrations
    description: Browse the team's catalog of available integration types
  - name: Connections
    description: Manage your connected integrations
  - name: Credentials
    description: >-
      Manage logins (domain + username + password + TOTP) used by agents to sign
      in to websites and desktop applications, and attach them to assignment
      revisions
  - name: Secrets
    description: >-
      Manage env-var secrets injected into runs, and attach them to assignment
      revisions. Only metadata is exposed; values are never returned
  - name: Revision Integrations
    description: >-
      Attach integrations to assignment revisions, pin specific connections, and
      link queues
  - name: ClarityV2
    description: >-
      Manage Clarity v2 process snapshots, transformation proposals, and the
      extra-capture-request follow-up loop
paths:
  /v2/agents/{agent_id}/revisions/{build_id}/case-queue-validation:
    get:
      tags:
        - Revision Integrations
      summary: Get Revision Case Queue Setup
      description: >-
        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.
      operationId: getRevisionCaseQueueSetup
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: agent_id
          required: true
          description: Agent ID
        - schema:
            type: string
```

--------------------------------

### POST /agents/{agentId}/revisions/{buildId}/logins

Source: https://docs.duvo.ai/api-reference

Attach a Login to a Setup.

```APIDOC
## POST /agents/{agentId}/revisions/{buildId}/logins

### Description
Attach a Login to a Setup.

### Method
POST

### Endpoint
/agents/{agentId}/revisions/{buildId}/logins
```

--------------------------------

### GET /profile

Source: https://docs.duvo.ai/api-reference

Get your user profile.

```APIDOC
## GET /profile

### Description
Get your user profile.

### Method
GET

### Endpoint
/profile
```

--------------------------------

### GET /connections/{connection_id}

Source: https://docs.duvo.ai/api-reference

Get a Connection.

```APIDOC
## GET /connections/{connection_id}

### Description
Get a Connection.

### Method
GET

### Endpoint
/connections/{connection_id}

### Parameters
#### Path Parameters
- **connection_id** (string) - Required - The ID of the connection.
```

--------------------------------

### GET /v2/artifacts/{artifactId}

Source: https://docs.duvo.ai/api-reference/duvo-pulse/get-pulse-dashboard

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.

```APIDOC
## GET /v2/artifacts/{artifactId}

### Description
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.

### Method
GET

### Endpoint
/v2/artifacts/{artifactId}

### Parameters
#### Path Parameters
- **artifactId** (string, uuid) - Required - The unique identifier of the artifact.

### Response
#### Success Response (200)
- **artifact** (object) - The artifact metadata object.
  - **id** (string, uuid) - The artifact ID.
  - **team_id** (string, nullable) - The ID of the team associated with the artifact.
```

--------------------------------

### Create a Sandbox

Source: https://docs.duvo.ai/user-guide/running-assignments/running-assignments-via-api

Initializes a new sandbox environment.

```APIDOC
## POST /sandboxes

### Description
Creates a new sandbox.

### Method
POST

### Endpoint
/sandboxes
```

--------------------------------

### GET /clarity-v2/processes/{process_id}

Source: https://docs.duvo.ai/api-reference

Get a process capture by ID.

```APIDOC
## GET /clarity-v2/processes/{process_id}

### Description
Get a process capture by ID.

### Method
GET

### Endpoint
/clarity-v2/processes/{process_id}

### Parameters
#### Path Parameters
- **process_id** (string) - Required - The ID of the process.
```

--------------------------------

### POST /clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}/promote

Source: https://docs.duvo.ai/api-reference

Promote a snapshot to live.

```APIDOC
## POST /clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}/promote

### Description
Promote a snapshot to live.

### Method
POST

### Endpoint
/clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}/promote

### Parameters
#### Path Parameters
- **process_id** (string) - Required - The ID of the process.
- **kind** (string) - Required - The kind of snapshot.
- **snapshot_id** (string) - Required - The ID of the snapshot.
```

--------------------------------

### GET /teams/{teamId}

Source: https://docs.duvo.ai/api-reference

Get your team's details.

```APIDOC
## GET /teams/{teamId}

### Description
Get your team's details.

### Method
GET

### Endpoint
/teams/{teamId}
```

--------------------------------

### GET /clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}

Source: https://docs.duvo.ai/api-reference

Get a process snapshot.

```APIDOC
## GET /clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}

### Description
Get a process snapshot.

### Method
GET

### Endpoint
/clarity-v2/processes/{process_id}/snapshots/{kind}/{snapshot_id}

### Parameters
#### Path Parameters
- **process_id** (string) - Required - The ID of the process.
- **kind** (string) - Required - The kind of snapshot.
- **snapshot_id** (string) - Required - The ID of the snapshot.
```

--------------------------------

### GET /connections/{connection_id}/credentials

Source: https://docs.duvo.ai/api-reference

Get the header keys configured for a Connection.

```APIDOC
## GET /connections/{connection_id}/credentials

### Description
Get the header keys configured for a Connection.

### Method
GET

### Endpoint
/connections/{connection_id}/credentials

### Parameters
#### Path Parameters
- **connection_id** (string) - Required - The ID of the connection.
```

--------------------------------

### POST /agents/{agent_id}/revisions/{build_id}/integrations

Source: https://docs.duvo.ai/api-reference

Attach one or more Connections to a Setup.

```APIDOC
## POST /agents/{agent_id}/revisions/{build_id}/integrations

### Description
Attach one or more Connections to a Setup.

### Method
POST

### Endpoint
/agents/{agent_id}/revisions/{build_id}/integrations
```

--------------------------------

### GET /v2/clarity-v2/processes/{process_id}/snapshots/{kind}

Source: https://docs.duvo.ai/api-reference/clarityv2/list-clarity-process-snapshots

List lightweight Clarity v2 process snapshots for one kind.

```APIDOC
## GET /v2/clarity-v2/processes/{process_id}/snapshots/{kind}

### Description
List lightweight Clarity v2 process snapshots for one kind.

### Method
GET

### Endpoint
/v2/clarity-v2/processes/{process_id}/snapshots/{kind}

### Parameters
#### Path Parameters
- **process_id** (string, uuid) - Required - The clarity process id
- **kind** (string) - Required - Snapshot kind to list (current_process, transformation_proposal)

#### Query Parameters
- **limit** (integer) - Optional - Default: 50. Minimum: 1, Maximum: 100.
- **offset** (integer) - Optional - Default: 0. Minimum: 0, Maximum: 9007199254740991.

### Response
#### Success Response (200)
- **Default Response** - Successful retrieval of snapshots.
```

--------------------------------

### GET /teams/{teamId}/browser-agent/credentials/{userId}/{id}

Source: https://docs.duvo.ai/api-reference

Get details of a specific login.

```APIDOC
## GET /teams/{teamId}/browser-agent/credentials/{userId}/{id}

### Description
Get a Login by its unique identifier.

### Method
GET

### Endpoint
/teams/{teamId}/browser-agent/credentials/{userId}/{id}

### Parameters
#### Path Parameters
- **teamId** (string) - Required - The unique identifier of the team.
- **userId** (string) - Required - The unique identifier of the user.
- **id** (string) - Required - The unique identifier of the login.
```

--------------------------------

### Manage process versions

Source: https://docs.duvo.ai/cli/clarity

List and interact with process snapshots.

```bash
duvo clarity versions <process-id>
duvo clarity current <process-id>
duvo clarity proposal <process-id>
duvo clarity compare <process-id>
```

--------------------------------

### GET /skills/{skill_id}/files/{path}

Source: https://docs.duvo.ai/api-reference

Get a Skill file's content.

```APIDOC
## GET /skills/{skill_id}/files/{path}

### Description
Get a Skill file's content.

### Method
GET

### Endpoint
/skills/{skill_id}/files/{path}

### Parameters
#### Path Parameters
- **skill_id** (string) - Required - The ID of the skill.
- **path** (string) - Required - The file path.
```

--------------------------------

### Create Agent and Start Run via Bash

Source: https://docs.duvo.ai/user-guide/running-assignments/creating-assignments-via-api

Uses curl to send POST requests for agent creation and run initiation. Requires jq for parsing JSON responses from the API.

```bash
#!/bin/bash
API_KEY="dv_your_api_key"
TEAM_ID="your-team-id"
BASE_URL="https://api.duvo.ai/v2"

# 1. Create an Agent with its first Revision
AGENT_RESPONSE=$(curl -s -X POST "$BASE_URL/teams/$TEAM_ID/agents" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Invoice Processor",
    "build": {
      "name": "v1",
      "config": {
        "version": "v2",
        "data": {
          "models": {
            "agent": { "model": "claude-sonnet-4-20250514" },
            "browsing": { "provider": "browserbase", "model": "gpt-4o" }
          },
          "input": "Process invoices from the uploaded files and extract line items.",
          "files": [],
          "skills": []
        }
      }
    }
  }')

AGENT_ID=$(echo $AGENT_RESPONSE | jq -r '.agent.id')
REVISION_ID=$(echo $AGENT_RESPONSE | jq -r '.build.id')
echo "Created Agent: $AGENT_ID with Revision: $REVISION_ID"

# 2. Start a Run on the new Agent
RUN_RESPONSE=$(curl -s -X POST "$BASE_URL/teams/$TEAM_ID/runs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"agent_id\": \"$AGENT_ID\"}")

RUN_ID=$(echo $RUN_RESPONSE | jq -r '.run.id')
echo "Started Run: $RUN_ID"
```

--------------------------------

### Get Notification Batch

Source: https://docs.duvo.ai/llms.txt

Get a single notification batch by id for the authenticated user.

```APIDOC
## GET /notification-batches/{id}

### Description
Get a single notification batch by id for the authenticated user, with per-type live-member counts, unread count, and worst severity.
```

--------------------------------

### Manage Clarity v2 snapshots via CLI

Source: https://docs.duvo.ai/cli/clarity

Use these commands to generate, save, promote, revert, and post-process process snapshots. Append --json to any command to receive the raw API response.

```bash
duvo clarity generate-current-process <process-id>
duvo clarity generate-transformation-proposal <process-id> \
  --current-process-id <current-snapshot-id>
duvo clarity generate-transformation-proposal <process-id> \
  --regenerate-from <proposal-snapshot-id>

duvo clarity save-current-process <process-id> \
  --baseline-snapshot-id <current-snapshot-id> \
  --steps-file edited-current-steps.json
duvo clarity save-transformation-proposal <process-id> \
  --baseline-snapshot-id <proposal-snapshot-id> \
  --steps-file edited-proposal-steps.json

duvo clarity promote-current-process <process-id> <current-snapshot-id>
duvo clarity promote-transformation-proposal <process-id> <proposal-snapshot-id>

duvo clarity revert-current-process <process-id> <current-snapshot-id>
duvo clarity revert-transformation-proposal <process-id> <proposal-snapshot-id>

duvo clarity postprocess <process-id> current_process <current-snapshot-id>
duvo clarity postprocess <process-id> transformation_proposal <proposal-snapshot-id>
duvo clarity assign-extra-capture-request <process-id> <proposal-snapshot-id> <request-id> \
  --user-id <user-id>
duvo clarity stop-current-process <process-id>
duvo clarity stop-transformation-proposal <process-id>
duvo clarity build-automation <process-id>
```
Tokens:
Raw