---
title: "Create a semantic table"
method: POST
path: "/data/projects/{projectId}/semantic-catalogs/{catalogId}"
tags: ["Data -- Semantic Catalogs"]
---

# Create a semantic table

`POST /data/projects/{projectId}/semantic-catalogs/{catalogId}`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/semantic-catalogs/{catalogId}`
- Auth: HTTP bearer

Creates a new Semantic Table within a Semantic Catalog. A Semantic Table maps a saved query to a table, making it queryable via SQL like any other table.

## Path parameters

- `projectId` string, required
- `catalogId` string, required

## Request body

- SemanticTableRequest
  - `schemaName` string: The name of the schema.
  - `tableName` string: The name of the table.
  - `queryId` string: The ID of the query which is used to populate the semantic table.

## Response `200`

Table created

- SemanticTable: Represents a table in a schema.
  - `catalogId` string: The ID of the catalog that the table belongs to.
  - `catalogName` string: The name of the catalog that the table belongs to.
  - `schemaName` string: The name of the schema that the table belongs to.
  - `tableName` string: The name of the table.
  - `tableId` string: The ID of the semantic table.

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)