---
title: "PATCH /catalogs/{name}"
method: PATCH
path: "/catalogs/{name}"
tags: ["CatalogsService"]
---

# PATCH /catalogs/{name}

`PATCH /catalogs/{name}`

Update a catalog

 Updates the catalog that matches the supplied name. The caller must be either
 the owner of the catalog, or a metastore admin (when changing the owner field of the catalog).

## Path parameters

- `name` string, required

## Request body

- UpdateCatalogRequest — Update a catalog
  - `name` string, required — Name of catalog.
  - `owner` string — Username of new owner of catalog.
  - `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 catalog.

## Response `200`

OK

- CatalogInfo — A catalog is a root-level namespace that contains schemas.
  - `id` string — Unique identifier for the catalog.
  - `name` string — Name of catalog.
  - `owner` string — Username of current owner of catalog.
  - `comment` string — User-provided free-form text description.
  - `properties` object — A map of key-value properties attached to the securable.
  - `storageRoot` string — Storage root URL for managed tables within catalog.
  - `providerName` string — The name of delta sharing provider. A Delta Sharing catalog is a catalog that is based on a Delta share on a remote sharing server.
  - `shareName` string — The name of the share under the share provider.
  - `catalogType` integer — The type of the catalog.
  - `createdAt` string — Time at which this catalog was created, in epoch milliseconds.
  - `createdBy` string — Username of catalog creator.
  - `updatedAt` string — Time at which this catalog was last updated, in epoch milliseconds.
  - `updatedBy` string — Username of user who last modified catalog.
  - `browseOnly` boolean — Indicates whether the principal is limited to retrieving metadata for the associated object through the BROWSE privilege when include_browse is enabled in the request.

## 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/revisions/a47a0389fffc/schema)