---
title: "Metadata columns vs actual LanceDB schema status"
method: GET
path: "/metadata_columns/status"
tags: ["metadata-columns"]
---

# Metadata columns vs actual LanceDB schema status

`GET /metadata_columns/status`

(reserved for future use) Reports the difference between declared metadata columns and the columns actually present in the tenant's LanceDB table (materialized at ingestion).

Required scope: \`knowledge:write\`

## Response `200`

Column status

- MetadataColumnsStatus
  - `columns` MetadataColumnsStatusEntry[], required
    - `key` string, required
    - `declared` boolean, required — Whether the column is declared in metadata_columns.
    - `present_in_lance` boolean, required — Whether the materialized column exists in the tenant's LanceDB table.
    - `non_null_count` integer, nullable — Number of rows with a non-null value in the materialized column. Null when the column does not exist in the tenant's LanceDB table.
  - `all_in_sync` boolean, required

## Other responses

- `401` — Unauthorized - Authentication failed
- `403` — Forbidden - the API key is missing the scope required by this endpoint

## Changes

> 71 revisions in range; 18 not diffed.

- **2026-06-17** `05add33422b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/metadata_columns/status/get.md)

---

[API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.dev/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/61dc40676905/schema)