---
title: "Get diagram components"
method: POST
path: "/clouddiagrams/v1/scheme/get"
tags: ["Cloud Diagrams"]
---

# Get diagram components

`POST /clouddiagrams/v1/scheme/get`

Returns diagram and layer data. When the request body is empty, returns all diagrams
the caller has access to. When the body is populated, returns full diagram data including
layer components projected to key display and cloud fields.

## Query parameters

- `components` boolean
- `external` boolean
- `element` boolean
- `link` boolean
- `group` boolean
- `note` boolean
- `combiner` boolean
- `type` string[]
- `node_type` 'app_component' | 'app_group' | 'app_link' | 'attachment' | 'group' | 'host' | 'link' | 'service'
- `alarms_count` boolean
- `issues_count` boolean
- `skip_empty` boolean
- `exclude_default_vpc` boolean
- `exclude_empty_subnets` boolean

## Request body

- CloudDiagramsGetRequest — Request body for getting diagram components. Leave empty to retrieve all accessible diagrams (returns scheme map only).
  - `scheme` string[] — IDs of diagrams to load.
  - `statussheet` string[] — IDs of layers to load.
  - `template` union — Template type or array of template layer IDs to include.
    - 'component' | 'statussheet'
    - string[]

## Response `200`

OK - Diagram and component data returned.

- CloudDiagramsGetResponse — Diagram and layer data. When called with an empty body, only the diagram map is populated. When called with a populated body, both diagram and layer maps are returned with components projected to key display and cloud fields by default.
  - `scheme` object — Map of diagram ID to diagram with its connected cloud accounts.
  - `statussheet` object — Map of layer ID to layer metadata and component collections. Components are projected to key display and cloud fields by default.
  - `template` object — Map of template layer ID to template data.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)