---
title: "Read an app definition"
description: "The whole definition: tables, views, rules, pages, members, theme, surfaces."
canonical: "https://gtable.app/docs/builder-api/apps/get"
updated: "2026-10-05"
---

# Read an app definition

`GET https://studio.gtable.app/v1/apps/{appId}`

The whole definition: tables, views, rules, pages, members, theme, surfaces.

Requires the `schema:read` scope. Operation `apps.get`. MCP tool `apps_get`. CLI, once published: `gtable apps get`.

## Path parameters

| Name    | Type   | Required | Description |
| ------- | ------ | -------- | ----------- |
| `appId` | string | yes      |             |