---
title: "PATCH /schemas/{fullName}"
method: PATCH
path: "/schemas/{fullName}"
tags: ["SchemasService"]
---

# PATCH /schemas/{fullName}

`PATCH /schemas/{fullName}`

Updates a schema for a catalog. The caller must be the owner of the schema or a metastore admin.
 If the caller is a metastore admin, only the owner field can be changed in the update.
 If the name field must be updated, the caller must be a metastore admin or have the CREATE_SCHEMA
 privilege on the parent catalog.

## Path parameters

- `fullName` string, required

## Request body

- UpdateSchemaRequest — Update a Schema
  - `fullName` string, required — Full name of schema, in form of catalog_name.schema_name.
  - `comment` string — User-provided free-form text description.
  - `properties` object — A map of key-value properties attached to the securable. When provided in update request, the specified properties will override the existing properties. To add and remove properties, one would need to perform a read-modify-write.
  - `newName` string — Name of schema.

## 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)