---
title: "Create a schema"
method: POST
path: "/schemas"
tags: ["Schemas"]
---

# Create a schema

`POST /schemas`

Creates a new schema in the specified catalog.

## Request body

- CreateSchema
  - `name` string, required — Name of schema, relative to parent catalog.
  - `catalog_name` string, required — Name of parent catalog.
  - `comment` string — User-provided free-form text description.
  - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.

## Response `200`

The new schema was successfully created.

- SchemaInfo
  - `name` string — Name of schema, relative to parent catalog.
  - `catalog_name` string — Name of parent catalog.
  - `comment` string — User-provided free-form text description.
  - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.
  - `full_name` string — Full name of schema, in form of __catalog_name__.__schema_name__.
  - `created_at` integer — Time at which this schema was created, in epoch milliseconds.
  - `updated_at` integer — Time at which this schema was last modified, in epoch milliseconds.
  - `schema_id` string — Unique identifier for the schema.

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) · [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitycatalog/unity-catalog-api/revisions/afb7536b3c70/schema)