---
title: "Insights"
url: "https://altiumdeveloper.github.io/platform-api-docs/reference/insights/overview"
bounded_context: "Insights"
kind: "overview"
experimental: false
deprecated: false
---

# Insights

Workspace insights about parts and designs.

For AI assistants: [llms.txt](https://altiumdeveloper.github.io/platform-api-docs/reference/insights/llms.txt) · [schema slice](https://altiumdeveloper.github.io/platform-api-docs/reference/insights/schema.graphql) · [all types](https://altiumdeveloper.github.io/platform-api-docs/reference/insights/types.txt)

## Common Data Model

- [Insights](https://altiumdeveloper.github.io/cdm/subsets/insights/) — Models insights: findings, detected asynchronously, that give the user insight within one domain area and can be followed up by tasks. There are two concrete kinds. A part insight concerns one Workspace part, may be informed by BOMs or design projects, and occurs in BOM releases, project releases or component revisions. A design insight concerns a design and is part of a design review.

## Entities

API types in this bounded context that represent Common Data Model (CDM) entities. The IRI is the entity's stable identifier in the CDM.

| API type | CDM entity |
| - | - |
| [`DesWorkspaceInsInsight`](https://altiumdeveloper.github.io/platform-api-docs/reference/insights/types/objects/des-workspace-ins-insight.md) | [Insight](https://w3id.org/altium/cdm/insights/Insight) [`https://w3id.org/altium/cdm/insights/Insight`](https://w3id.org/altium/cdm/insights/Insight) |

## Entry points

Look up entities by identifier:

- [`desWorkspaceInsInsightById`](https://altiumdeveloper.github.io/platform-api-docs/reference/insights/operations/queries/des-workspace-ins-insight-by-id.md)

## Contents

| Kind | Items | Experimental |
| - | - | - |
| Queries | 9 | 0 |
| Mutations | 6 | 0 |
| Objects | 36 | 0 |
| Inputs | 14 | 0 |
| Unions | 1 | 0 |