---
title: "Gets metadata information"
method: GET
path: "/apps/{appId}/metadata"
---

# Gets metadata information

`GET /apps/{appId}/metadata`

Retrieve the metadata information for the app, including its schema, etc.

## Path parameters

- `appId` string, required

## Response `200`

Successful response

- MetadataResults — The metadata result for the app, including available tables, etc.
  - `tableGroups` MetadataTableGroup[] — The list of groups of tables on the app.
    - `id` string, required — The ID of the table group
    - `name` string, required — The name of the table group
    - `source` string — The source of the table group, can be either AI or OMS for Log Analytics workspaces
    - `displayName` string — The display name of the table group
    - `description` string — The description of the table group
    - `tables` string[] — The list of tables contained in the table group
  - `tables` MetadataTable[] — The list of tables and columns that comprise the schema of the app.
    - `id` string, required — The ID of the table
    - `name` string, required — The name of the table
    - `description` string — The description of the table
    - `timespanColumn` string — The column associated with the timespan query parameter for the table
    - `columns` object[] — The list of columns defined on the table
      - `name` string, required — The name of the column
      - `description` string — The description of the column
      - `type` 'bool' | 'datetime' | 'dynamic' | 'int' | 'long' | 'real' | 'string', required — The data type of the column
      - `isPreferredFacet` boolean — A flag indicating this column is a preferred facet
      - `source` object — an indication of the source of the column, used only when multiple apps have conflicting definition for the column
  - `functions` MetadataFunction[] — The list of functions stored on the app.
    - `id` string, required — The ID of the function.
    - `name` string, required — The name of the function, to be used in queries.
    - `parameters` string — The parameters/arguments of the function, if any.
    - `displayName` string — The display name of the function.
    - `description` string — The description of the function.
    - `body` string, required — The KQL body of the function.
  - `applications` MetadataApplication[] — The list of Application Insights apps that were referenced in the metadata request.
    - `id` string, required — The ID of the Application Insights app.
    - `resourceId` string, required — The ARM resource ID of the Application Insights app.
    - `name` string, required — The name of the Application Insights app.
    - `region` string, required — The Azure region of the Application Insights app.
    - `tables` string[] — The list of custom tables for the Application Insights app.
    - `functions` string[] — The list of stored functions on the Application Insights app
    - `tableGroups` string[] — The list of table groups on the Application Insights app

## Other responses

- `default` — An error response object.

## Changes

- **2026-07-13** (2018-04-20) `5ba59b0ed852` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/applicationinsights-insights/changes/apps/:appId/metadata/get.md)

---

[API](https://skmtc.dev/azure/apis/applicationinsights-insights.md) · [All operations](https://skmtc.dev/azure/apis/applicationinsights-insights/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/applicationinsights-insights/revisions/5ba59b0ed852/schema)