---
title: "Get Clarity Process Landscape"
method: GET
path: "/v2/organizations/{orgId}/clarity/hierarchy/landscape"
tags: ["Organizations", "Clarity"]
---

# Get Clarity Process Landscape

`GET /v2/organizations/{orgId}/clarity/hierarchy/landscape`

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/organizations/{orgId}/clarity/hierarchy/landscape`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/organizations/:orgId/clarity/hierarchy/landscape/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch the organization's process landscape: hierarchy nodes joined to lean process summaries and team assignments, with page-level stats

## Path parameters

- `orgId` string, uuid, required

## Query parameters

- `rootId` string, uuid

## Response `200`

Default Response

- object
  - `nodes` object[], required
    - `id` string, uuid, required
    - `parentId` string, uuid, nullable, required
    - `processId` string, uuid, nullable, required
    - `name` string, required
    - `ownerLabel` string, nullable, required
    - `sortOrder` number, required
    - `depth` number, required
    - `existence` 'proposed' | 'active', required
    - `contentConfirmedAt` string, nullable, required
    - `existenceConfirmedAt` string, nullable, required
    - `source` 'ai' | 'human', required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `process` object, nullable, required
      - `id` string, uuid, required
      - `name` string, required
      - `status` 'draft' | 'collecting' | 'generating' | 'generating-current-process' | 'generating-transformation-proposal' | 'review' | 'complete' | 'generation_failed', required
      - `version` union, required
        - 1
        - 2
      - `summary` string, nullable, required
      - `captureCount` number, required
      - `captureCounts` object, required
        - `video` number, required
        - `interview` number, required
        - `document` number, required
      - `contributors` object[], required
        - `userId` string, required
        - `userName` string, required
      - `people` object[], required
        - `id` string, required
        - `userId` string, nullable, required
        - `email` string, nullable, required
        - `name` string, required
      - `updatedAt` string, date-time, required
    - `proposedSummary` string, nullable, required
    - `teamId` string, uuid, nullable
    - `teamName` string, nullable
    - `assignedTeam` object, nullable
      - `id` string, uuid, required
      - `name` string, required
    - `teamAssignmentSuggestions` object[]
      - `id` string, uuid, required
      - `suggestedTeamId` string, uuid, nullable, required
      - `suggestedTeamName` string, required
      - `confidence` number, required
      - `rationale` string, required
      - `status` 'pending' | 'accepted' | 'dismissed', required
      - `createdAt` string, required
    - `captureSuggestions` object[]
      - `id` string, uuid, required
      - `suggestedUserId` string, uuid, nullable, required
      - `suggestedUserName` string, nullable, required
      - `suggestedTeamId` string, uuid, nullable, required
      - `suggestedTeamName` string, nullable, required
      - `gap` string, required
      - `suggestedPrompt` string, nullable, required
      - `confidence` number, required
      - `rationale` string, required
      - `status` 'pending' | 'accepted' | 'dismissed', required
      - `createdAt` string, required
    - `captureRequests` object[]
      - `id` string, uuid, required
      - `requestedUserId` string, uuid, nullable, required
      - `requestedUserName` string, nullable, required
      - `assignedByUserId` string, uuid, nullable
      - `requestedTeamId` string, uuid, nullable, required
      - `requestedTeamName` string, nullable, required
      - `gap` string, required
      - `prompt` string, nullable, required
      - `status` 'open' | 'completed' | 'cancelled', required
      - `createdAt` string, required
    - `labels` object[], required
      - `id` string, uuid, required
      - `value` string, required
      - `colorHue` integer, required
      - `source` 'human' | 'agent', required
  - `links` object[], required
    - `id` string, uuid, required
    - `sourceNodeId` string, uuid, required
    - `targetNodeId` string, uuid, required
    - `type` 'hands_off_to' | 'shares_step_with' | 'variant_of', required
    - `state` 'suggested' | 'confirmed', required
    - `confidence` number, nullable, required
    - `rationale` string, nullable, required
  - `unlinkedProcesses` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'draft' | 'collecting' | 'generating' | 'generating-current-process' | 'generating-transformation-proposal' | 'review' | 'complete' | 'generation_failed', required
    - `version` union, required
      - 1
      - 2
    - `summary` string, nullable, required
    - `captureCount` number, required
    - `captureCounts` object, required
      - `video` number, required
      - `interview` number, required
      - `document` number, required
    - `contributors` object[], required
      - `userId` string, required
      - `userName` string, required
    - `people` object[], required
      - `id` string, required
      - `userId` string, nullable, required
      - `email` string, nullable, required
      - `name` string, required
    - `updatedAt` string, date-time, required
    - `teamId` string, uuid, required
    - `teamName` string, nullable, required
    - `labels` object[], required
      - `id` string, uuid, required
      - `value` string, required
      - `colorHue` integer, required
      - `source` 'human' | 'agent', required
  - `stats` object, required
    - `totalNodes` number, required
    - `processNodes` number, required
    - `proposedNodes` number, required
    - `unsortedProcesses` number, required
    - `latestUpdatedAt` string, nullable, required
  - `generation` object, required
    - `eligibleCaptureCount` integer, required
    - `eligibleProcessCount` integer, required
    - `status` 'idle' | 'starting' | 'running' | 'completed' | 'failed', required
  - `truncated` boolean, required

---

[API](https://skmtc.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)