> ## 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. # Create Clarity Process Link > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /v2/organizations/{orgId}/clarity/hierarchy/process-links 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: 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/organizations/{orgId}/clarity/hierarchy/process-links: post: tags: - Clarity summary: Create Clarity Process Link description: >- 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. operationId: createClarityProcessLink parameters: - schema: type: string format: uuid in: path name: orgId required: true requestBody: required: true content: application/json: schema: type: object properties: source_node_id: type: string format: uuid description: Hierarchy node id for the source process target_node_id: type: string format: uuid description: Hierarchy node id for the target process type: type: string enum: - hands_off_to - shares_step_with - variant_of description: >- Relationship type between the source process node and target process node state: default: confirmed type: string enum: - suggested - confirmed description: Whether the link is suggested by Duvo or confirmed by a user confidence: nullable: true description: Optional confidence score from 0 to 1 type: number minimum: 0 maximum: 1 required: - source_node_id - target_node_id - type responses: '200': description: Default Response content: application/json: schema: type: object properties: process_link: type: object properties: id: type: string format: uuid description: Unique process-link identifier source_node_id: type: string format: uuid description: Hierarchy node id for the source process target_node_id: type: string format: uuid description: Hierarchy node id for the target process type: type: string enum: - hands_off_to - shares_step_with - variant_of description: >- Relationship type between the source process node and target process node state: type: string enum: - suggested - confirmed description: >- Whether the link is suggested by Duvo or confirmed by a user confidence: nullable: true description: Optional confidence score from 0 to 1 type: number minimum: 0 maximum: 1 rationale: nullable: true description: Why Duvo suggested this process relationship type: string created_at: type: string description: ISO 8601 creation timestamp updated_at: type: string description: ISO 8601 last-updated timestamp required: - id - source_node_id - target_node_id - type - state - confidence - rationale - created_at - updated_at additionalProperties: false created: description: True when a create request inserted a new link type: boolean required: - process_link additionalProperties: false '201': description: Default Response content: application/json: schema: type: object properties: process_link: type: object properties: id: type: string format: uuid description: Unique process-link identifier source_node_id: type: string format: uuid description: Hierarchy node id for the source process target_node_id: type: string format: uuid description: Hierarchy node id for the target process type: type: string enum: - hands_off_to - shares_step_with - variant_of description: >- Relationship type between the source process node and target process node state: type: string enum: - suggested - confirmed description: >- Whether the link is suggested by Duvo or confirmed by a user confidence: nullable: true description: Optional confidence score from 0 to 1 type: number minimum: 0 maximum: 1 rationale: nullable: true description: Why Duvo suggested this process relationship type: string created_at: type: string description: ISO 8601 creation timestamp updated_at: type: string description: ISO 8601 last-updated timestamp required: - id - source_node_id - target_node_id - type - state - confidence - rationale - created_at - updated_at additionalProperties: false created: description: True when a create request inserted a new link type: boolean required: - process_link additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error 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 '409': description: Default Response content: application/json: schema: type: object properties: error: type: string message: type: string required: - error additionalProperties: false '422': 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. ````