> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Duplicate Clarity Process

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



## OpenAPI

````yaml /api-reference/openapi.json post /v2/clarity/processes/{id}/duplicate
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: Invites
    description: >-
      Invite people to a team — one at a time or in bulk, scoped to a Clarity
      process or the whole team — and manage the team's shareable invite link
  - 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/clarity/processes/{id}/duplicate:
    post:
      tags:
        - Clarity
      summary: Duplicate Clarity Process
      description: >-
        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.
      operationId: duplicateClarityProcess
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: id
          required: true
          description: Source Clarity process id
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Duplicated Clarity process id
                  sourceTeamId:
                    type: string
                    format: uuid
                  organizationId:
                    nullable: true
                    type: string
                    format: uuid
                  process:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      name:
                        type: string
                      status:
                        type: string
                        enum:
                          - draft
                          - collecting
                          - generating
                          - generating-current-process
                          - generating-transformation-proposal
                          - review
                          - complete
                          - generation_failed
                      version:
                        anyOf:
                          - type: number
                            enum:
                              - 1
                          - type: number
                            enum:
                              - 2
                      summary:
                        nullable: true
                        type: string
                      captureCount:
                        type: number
                      captureCounts:
                        type: object
                        properties:
                          video:
                            type: number
                          interview:
                            type: number
                          document:
                            type: number
                          meeting:
                            type: number
                          other:
                            type: number
                        required:
                          - video
                          - interview
                          - document
                        additionalProperties: false
                      updatedAt:
                        type: string
                        format: date-time
                      contributors:
                        type: array
                        items:
                          type: object
                          properties:
                            userId:
                              type: string
                            userName:
                              type: string
                          required:
                            - userId
                            - userName
                          additionalProperties: false
                      people:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            userId:
                              nullable: true
                              type: string
                            email:
                              nullable: true
                              type: string
                            name:
                              type: string
                          required:
                            - id
                            - userId
                            - email
                            - name
                          additionalProperties: false
                      createdAt:
                        type: string
                        format: date-time
                      createdByUserId:
                        type: string
                        format: uuid
                      createdByDisplay:
                        nullable: true
                        type: object
                        properties:
                          userId:
                            type: string
                            format: uuid
                          name:
                            type: string
                        required:
                          - userId
                          - name
                        additionalProperties: false
                      insightsCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      vulnerabilityCount:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      acceptedInviteeUserIds:
                        type: array
                        items:
                          type: string
                          format: uuid
                      acceptedInviteeDisplays:
                        type: array
                        items:
                          type: object
                          properties:
                            userId:
                              type: string
                              format: uuid
                            name:
                              type: string
                          required:
                            - userId
                            - name
                          additionalProperties: false
                      currentUserConnections:
                        type: array
                        items:
                          type: string
                          enum:
                            - owner
                            - contributor
                            - assigned
                            - accepted_invitation
                      teamId:
                        type: string
                        format: uuid
                      teamName:
                        nullable: true
                        type: string
                      labels:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            value:
                              type: string
                            colorHue:
                              type: integer
                              minimum: 0
                              maximum: 360
                            source:
                              type: string
                              enum:
                                - human
                                - agent
                          required:
                            - id
                            - value
                            - colorHue
                            - source
                          additionalProperties: false
                    required:
                      - id
                      - name
                      - status
                      - version
                      - summary
                      - captureCount
                      - captureCounts
                      - updatedAt
                      - contributors
                      - people
                      - teamId
                      - teamName
                      - labels
                    additionalProperties: false
                  node:
                    nullable: true
                    type: object
                    properties:
                      access:
                        type: string
                        enum:
                          - full
                      id:
                        type: string
                        format: uuid
                      parentId:
                        nullable: true
                        type: string
                        format: uuid
                      processId:
                        nullable: true
                        type: string
                        format: uuid
                      name:
                        type: string
                      ownerLabel:
                        nullable: true
                        type: string
                      sortOrder:
                        type: number
                      depth:
                        type: number
                      existence:
                        type: string
                        enum:
                          - proposed
                          - active
                      contentConfirmedAt:
                        nullable: true
                        type: string
                      existenceConfirmedAt:
                        nullable: true
                        type: string
                      source:
                        type: string
                        enum:
                          - ai
                          - human
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                      process:
                        nullable: true
                        type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                          name:
                            type: string
                          status:
                            type: string
                            enum:
                              - draft
                              - collecting
                              - generating
                              - generating-current-process
                              - generating-transformation-proposal
                              - review
                              - complete
                              - generation_failed
                          version:
                            anyOf:
                              - type: number
                                enum:
                                  - 1
                              - type: number
                                enum:
                                  - 2
                          summary:
                            nullable: true
                            type: string
                          captureCount:
                            type: number
                          captureCounts:
                            type: object
                            properties:
                              video:
                                type: number
                              interview:
                                type: number
                              document:
                                type: number
                              meeting:
                                type: number
                              other:
                                type: number
                            required:
                              - video
                              - interview
                              - document
                            additionalProperties: false
                          updatedAt:
                            type: string
                            format: date-time
                          contributors:
                            type: array
                            items:
                              type: object
                              properties:
                                userId:
                                  type: string
                                userName:
                                  type: string
                              required:
                                - userId
                                - userName
                              additionalProperties: false
                          people:
                            default: []
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                userId:
                                  nullable: true
                                  type: string
                                email:
                                  nullable: true
                                  type: string
                                name:
                                  type: string
                              required:
                                - id
                                - userId
                                - email
                                - name
                              additionalProperties: false
                          createdAt:
                            type: string
                            format: date-time
                          createdByUserId:
                            type: string
                            format: uuid
                          createdByDisplay:
                            nullable: true
                            type: object
                            properties:
                              userId:
                                type: string
                                format: uuid
                              name:
                                type: string
                            required:
                              - userId
                              - name
                            additionalProperties: false
                          insightsCount:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          vulnerabilityCount:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          acceptedInviteeUserIds:
                            type: array
                            items:
                              type: string
                              format: uuid
                          acceptedInviteeDisplays:
                            type: array
                            items:
                              type: object
                              properties:
                                userId:
                                  type: string
                                  format: uuid
                                name:
                                  type: string
                              required:
                                - userId
                                - name
                              additionalProperties: false
                          currentUserConnections:
                            type: array
                            items:
                              type: string
                              enum:
                                - owner
                                - contributor
                                - assigned
                                - accepted_invitation
                        required:
                          - id
                          - name
                          - status
                          - version
                          - summary
                          - captureCount
                          - captureCounts
                          - updatedAt
                          - contributors
                          - people
                        additionalProperties: false
                      proposedSummary:
                        nullable: true
                        type: string
                      priority:
                        nullable: true
                        type: string
                        enum:
                          - high
                          - medium
                          - low
                      priorityReasoning:
                        nullable: true
                        type: string
                      priorityAssessedAt:
                        nullable: true
                        type: string
                      teamId:
                        nullable: true
                        type: string
                        format: uuid
                      teamName:
                        nullable: true
                        type: string
                      assignedTeam:
                        nullable: true
                        type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                          name:
                            type: string
                        required:
                          - id
                          - name
                        additionalProperties: false
                      teamAssignmentSuggestions:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            suggestedTeamId:
                              nullable: true
                              type: string
                              format: uuid
                            suggestedTeamName:
                              type: string
                            confidence:
                              type: number
                              minimum: 0
                              maximum: 1
                            rationale:
                              type: string
                            status:
                              type: string
                              enum:
                                - pending
                                - accepted
                                - dismissed
                            createdAt:
                              type: string
                          required:
                            - id
                            - suggestedTeamId
                            - suggestedTeamName
                            - confidence
                            - rationale
                            - status
                            - createdAt
                          additionalProperties: false
                      captureSuggestions:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            suggestedUserId:
                              nullable: true
                              type: string
                              format: uuid
                            suggestedUserName:
                              nullable: true
                              type: string
                            suggestedTeamId:
                              nullable: true
                              type: string
                              format: uuid
                            suggestedTeamName:
                              nullable: true
                              type: string
                            gap:
                              type: string
                              minLength: 1
                            suggestedPrompt:
                              nullable: true
                              type: string
                            confidence:
                              type: number
                              minimum: 0
                              maximum: 1
                            rationale:
                              type: string
                              minLength: 1
                            status:
                              type: string
                              enum:
                                - pending
                                - accepted
                                - dismissed
                            createdAt:
                              type: string
                          required:
                            - id
                            - suggestedUserId
                            - suggestedUserName
                            - suggestedTeamId
                            - suggestedTeamName
                            - gap
                            - suggestedPrompt
                            - confidence
                            - rationale
                            - status
                            - createdAt
                          additionalProperties: false
                      captureRequests:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            requestedUserId:
                              nullable: true
                              type: string
                              format: uuid
                            requestedUserName:
                              nullable: true
                              type: string
                            assignedByUserId:
                              nullable: true
                              type: string
                              format: uuid
                            requestedTeamId:
                              nullable: true
                              type: string
                              format: uuid
                            requestedTeamName:
                              nullable: true
                              type: string
                            gap:
                              type: string
                              minLength: 1
                            prompt:
                              nullable: true
                              type: string
                            status:
                              type: string
                              enum:
                                - open
                                - completed
                                - cancelled
                            createdAt:
                              type: string
                          required:
                            - id
                            - requestedUserId
                            - requestedUserName
                            - requestedTeamId
                            - requestedTeamName
                            - gap
                            - prompt
                            - status
                            - createdAt
                          additionalProperties: false
                      labels:
                        default: []
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                            value:
                              type: string
                            colorHue:
                              type: integer
                              minimum: 0
                              maximum: 360
                            source:
                              type: string
                              enum:
                                - human
                                - agent
                          required:
                            - id
                            - value
                            - colorHue
                            - source
                          additionalProperties: false
                    required:
                      - access
                      - id
                      - parentId
                      - processId
                      - name
                      - ownerLabel
                      - sortOrder
                      - depth
                      - existence
                      - contentConfirmedAt
                      - existenceConfirmedAt
                      - source
                      - createdAt
                      - updatedAt
                      - process
                      - proposedSummary
                      - teamAssignmentSuggestions
                      - captureSuggestions
                      - captureRequests
                      - labels
                    additionalProperties: false
                  directProcessHref:
                    type: string
                required:
                  - id
                  - sourceTeamId
                  - organizationId
                  - process
                  - node
                  - directProcessHref
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
                required:
                  - error
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Get your API key from the Duvo dashboard.

````