---
title: "POST /schemas"
method: POST
path: "/schemas"
tags: ["SchemasService"]
---

# POST /schemas

`POST /schemas`

Creates a new schema for catalog in the Metatastore. The caller must be a metastore admin,
 or have the CREATE_SCHEMA privilege in the parent catalog.

## Request body

- CreateSchemaRequest — Create a new Schema
  - `name` string, required — Name of schema, relative to parent catalog.
  - `catalogName` string, required — Name of parent catalog.
  - `comment` string — User-provided free-form text description.
  - `properties` object — A map of key-value properties attached to the securable.

## Response `200`

OK

- SchemaInfo — A schema is a namespace within a catalog that contains tables.
  - `name` string, required — Name of schema, relative to parent catalog.
  - `catalogName` string, required — Name of parent catalog.
  - `comment` string — User-provided free-form text description.
  - `properties` object — A map of key-value properties attached to the securable.
  - `fullName` string — Full name of schema, in form of catalog_name.schema_name.
  - `owner` string — Username of current owner of schema.
  - `createdAt` string — Time at which this schema was created, in epoch milliseconds.
  - `createdBy` string — Username of schema creator.
  - `updatedAt` string — Time at which this schema was last updated, in epoch milliseconds.
  - `updatedBy` string — Username of user who last modified schema.
  - `schemaId` string — Unique identifier for the schema.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/delta-incubator/apis/delta-sharing-api.md) · [All operations](https://skmtc.net/delta-incubator/apis/delta-sharing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/delta-incubator/delta-sharing-api/versions/a47a0389fffc/schema)