---
title: "Diagnose canonical unit resolution in development"
method: GET
path: "/customers/{customerId}/knowledge/units/diagnostics"
tags: ["Document Platform"]
---

# Diagnose canonical unit resolution in development

`GET /customers/{customerId}/knowledge/units/diagnostics`

## Request

- Base URL: `http://localhost:9000`
- URL: `http://localhost:9000/customers/{customerId}/knowledge/units/diagnostics`
- Auth: API key in header `x-api-key`

## Path parameters

- `customerId` string, uuid, required

## Response `200`

Default Response

- object
  - `incomplete` boolean, required
  - `failures` object[], required
    - `operation` 'source_setup' | 'source_list' | 'source_validate' | 'source_read' | 'source_decode' | 'schema_validate' | 'identity_validate' | 'asset_join' | 'building_read' | 'building_join' | 'resolution', required
    - `reason` 'operation_failed' | 'access_denied' | 'authentication_failed' | 'timeout' | 'invalid_data' | 'not_found' | 'ambiguous_identity' | 'missing_asset' | 'unmapped_asset' | 'disposed_asset' | 'missing_building' | 'inactive_building' | 'archived_building' | 'foreign_building' | 'limit_exceeded' | 'deadline_exceeded', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-20** `83d02a8ada4e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/findable/apis/findable-api/changes/customers/:customerId/knowledge/units/diagnostics/get.md)

---

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