---
title: "Controller Handle Introspect Table"
method: POST
path: "/integrations/introspect/table"
tags: ["integrations"]
---

# Controller Handle Introspect Table

`POST /integrations/introspect/table`

Introspects a table, provided the flow we're working in for necessary credentials context.

## Request body

- IntrospectTablePayload
  - `flow_id` string, required — Flow ID that this is in context of. Necessary to track down the connection we should use for credentials.
  - `connection_id` string, nullable — Connection to use for introspection. If not provided, use the connection attached to the flow (older meltano deployments)] = None.
  - `table_config` object, nullable — Any additional config used for the introspection, not on the general connection
  - `specifier` object, required — The specifier used to track down the table. We expect a specifier rather than a full table specifier because we use this in a context where we are not working with an existing connection

## Response `200`

Successful Response

- Table
  - `name` string, required — Name of the table.
  - `schema` string, nullable — Schema of the table. Only provided for sources that have some concept of a 'wrapper' schema.
  - `columns` Column[], required — List of columns in the table.
    - `name` string, required — Name of the column.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/akkio/apis/fastapi.md) · [All operations](https://skmtc.net/akkio/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akkio/fastapi/versions/6662a407c637/schema)