> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# describe_table

> **Describe table**

Describe the columns of a table or worksheet: type, description (cut at 200 characters; describe_column covers a single column in full), and values for enum and select columns. Data tables also list numeric ranges and the distinct values of low-cardinality text columns. Columns with `entity_reference` or `label_mapped` hold ids, so filter them by id. Works on worksheets and customDataTables only.

The result opens with a Data coverage block. Its Sync window line is the floor of what data exists, and its row count applies the table's admin Table View filters. Column profiles ignore those filters, so a listed value can match no rows in reads and aggregations.



## OpenAPI

````yaml /api-reference/tools-openapi.json post /v1/describe_table
openapi: 3.1.0
info:
  title: Rippit API
  version: 1.0.0
  description: Every operation is also an MCP tool with the same name and parameters.
servers:
  - url: https://api.rippit.com
security:
  - bearer: []
paths:
  /v1/describe_table:
    post:
      summary: describe_table
      description: >-
        **Describe table**


        Describe the columns of a table or worksheet: type, description (cut at
        200 characters; describe_column covers a single column in full), and
        values for enum and select columns. Data tables also list numeric ranges
        and the distinct values of low-cardinality text columns. Columns with
        `entity_reference` or `label_mapped` hold ids, so filter them by id.
        Works on worksheets and customDataTables only.


        The result opens with a Data coverage block. Its Sync window line is the
        floor of what data exists, and its row count applies the table's admin
        Table View filters. Column profiles ignore those filters, so a listed
        value can match no rows in reads and aggregations.
      operationId: describe_table
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tableId:
                  type: string
                  minLength: 1
                  pattern: ^[A-Za-z0-9_-]+$
                  description: Data table or worksheet id.
              required:
                - tableId
              additionalProperties: false
      responses:
        '200':
          description: Tool result.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.