---
id: catalog-specification-update
title: "Update a catalog specification"
description: "Updates a catalog specification."
sidebar_label: "Update a catalog specification"
hide_title: true
hide_table_of_contents: true
api: eJztWG1v2zYQ/ivEYR+SVXlrk6IVMBRp2qIp1jTIy1Yg8YKzeLbZSKRKUmk9R/99OFK25ZekQbFmw5ZPlkne8fjcw+dIjsCUZNEro/clpJChx9z0L1xJmeqpLPSkVSnREyTgse8gPYO9OEzMDINOApJcZlUZ/qZwGuycQJEtM1iHBCx9rsj5l0YOIR1BZrQn7fkTyzJvBm58cuxvBC4bUIH85ZXPCVJ4Tx4lejyeiSQBPyy523Q/UeYhgdLyQr0iN+dnbpykHlY5B1DPr2bpokV0tS7eV86LLgkUV5grKd4dfzgQx7ET6gQ0FtSa0HmrdB8SKJT+lXTfDyDdutuM7CkRPWMFfcWizCkVLyuVS7FnrshinxKxO8VOvLFY0BdjL13SjPutyjVZ7KpcMSAhvJmJ/44oW2PWoV4A80MAXFgqLTnSXun+TTQJS0Whqzwvc/Q9YwvBFn4ICTQQcMwRYTjAglyJGYnA1vmJd6UMHQKduKTh2hXmFYmYf+FNQDeahzmYMAloy6bG9lGrP0NQv2zx5DGKFCZGDFXDSEihCeBmts2yshheRMAvmvbhslR47EPqbUV1wha6Krpkl1nEnjanNxtrtssq501x4bF/EYCL3mJky7zdHLMm50neEnNdc/55pytLkvVjyUo7CaCUirHF/LA1Rw9zR3X08SM4VCdQIu8RT5bFbZnK7MuppEwSwU7QQwpVpeQCz061+lyR2H8VpvaDhk/DRCgtTk9je4E+7D7FFiX6AYyFAoLLKWac8G9PcYPM1p0EHGWVDWw9G0GX0JLdrXg/n3W425IrjXYxqY8/fuSfH7Nj70nilbzPBP7L1T3o1xSNg6ODJXCU6D0FoftjRulWzs/lo+vz859XH628SFPMMlNp32pefcHtEw1c6GmleaFvpctBX7vMlHRtKSd0dI3Okb+WVOZmWJD2qzNmPy2k6qBNtCNyprIZCS4EYuXg6GB1nrQDRRZtNlAZ5kJJbu8psgH1GdLaxldEcSz3i2meDecQLWnf0EX4AXoxMLl0YlwahNKRO80hiHRVsCy2YYcEGqQbTRjXlxaakECAj1sZslBrTElBOQKUIbYxjJBA5chCp25XqcXVMATYZaZE1bmNxK/jIicru6ThHHuzCW97La5e3f8Z5LZC/IOOffdx7GGhg60n2zvb2/h0DTefPV/bftLFtedy5/HaTvcpPaXtHj6TW9Pa8nBE+q8ekeoEtpcV7zdBbgKlZrhH1hrrhKx4JrF7uC+U9mQxYzv3PdX6NXv89gXMo6/cnpG0PBvt2N+enByKaCAyI0koLUMcuh/Lcpix5ljl0iK8tK4Hq+gvotIjSzojgVryhqS+sWMpZu0Pk3zT+fHAWJ+IQVWgXrOEknW0mYstBc8ZnYeTZ0HOYf8OUb8ijyon2fhq7ERpzZWSQUUmzBAhZ1/9Evn5bhq0mdnK3RiX6UI6kYQ7DyR8IOE/S8J4yBkYGa9W2SAecQeQwsa4AE0+Zh+8NkZK1lyVyF6NL4WVzSGFgfelSzc2sFTr7cq8npli5poVjgCRZu3L1gRhdjSue/w/DuIDXfh4M76avPv9JEDIXD+avpW9fnj2+H/UdH4b6Jm2tjXnUUiAuRmzu7m+tb4ZXjKM8wXqFi/iG+xNh8x5nrReYO/yetssmDf6RpmjCioVdsqo2WtnU2JMOXIxH0OqJCMxMM6zyWjURUenNq9rbv5ckeV3i04CV2hVvJqcjUAqx9+yAeuWpawcNVlYFXd+NLlhdU0jaj6Gh10EKUAClzSMrzY1X68GhJJsiDJ27MVY1k6G4Xo2NlwoZ3UyttjNMir9rWM7LYk73D3Ze8v60bykF6EOgcUvrJz4JUZpyiim6Si2jSBH3a+C+kN0ypzDWbGaE6ewrKU4jEZxxIm5JF3XE1g8/2dk6vovNfOgpA==
sidebar_class_name: "patch api-method"
info_path: docs/api/catalog
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Update a catalog specification"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/metadata/metadata_specification/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Updates a catalog specification.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"schema":{"title":"Id","type":"string","format":"uuid","description":"Unique ID for the entity, in UUID format."},"in":"path","name":"id","required":true,"description":"Unique ID for the catalog specification."}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"title":"MetadataSpecification","type":"object","properties":{"schema":{"type":"object","default":{},"description":"Catalog specification schema. Must be a valid JSON Schema."},"name":{"type":"string","minLength":1,"description":"Catalog specification name, for example: Build Coverage, Application Frameworks, Build Vulnerabilities."},"description":{"type":"string","minLength":1,"description":"Catalog specification description."}},"description":"Object representing a catalog specification for a nullplatform entity","example":{"name":"Namespace tags","description":"Add tags as key-value object to namespace entities","nrn":"organization=1","entity":"namespace","metadata":"tags","schema":{"type":"object","properties":{"my_string_property":{"type":"string","tag":true},"my_number_property":{"type":"number","default":0,"tag":"my_custom_tag_name"},"my_object_property":{"type":"object","properties":{"my_nested_property":{"type":"string"}}}},"required":["my_string_property"],"additionalProperties":false}}}}},"description":"Object representing a catalog specification for a nullplatform entity"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a catalog specification for a nullplatform entity","content":{"application/json":{"schema":{"title":"MetadataSpecification","type":"object","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique ID for the entity, in UUID format."},"name":{"type":"string","minLength":1,"description":"Catalog specification name, for example: Build Coverage, Application Frameworks, Build Vulnerabilities."},"nrn":{"title":"NRN","type":"string","pattern":"^organization=(\\d+|\\*)+(?::account=(\\d+|\\*))?(?::namespace=(\\d+|\\*))?(?::application=(\\d+|\\*))?(?::(build|scope|release|asset|deployment)=(\\d+|\\*))?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources."},"entity":{"type":"string","description":"Parent entity that holds metadata information.","enum":["organization","account","namespace","application","build","asset","scope","release","deployment","user"]},"metadata":{"type":"string","nullable":true,"minLength":1,"description":"Entity metadata key, for example: coverage, frameworks, vulnerabilities."},"description":{"type":"string","minLength":1,"description":"Catalog specification description."},"schema":{"type":"object","default":{},"description":"Catalog specification schema. Must be a valid JSON Schema."}},"description":"Object representing a catalog specification for a nullplatform entity","example":{"id":"134544a6-a089-43ba-9d52-5b6e6e4fa8d1","name":"Namespace tags","description":"Add tags as key-value object to namespace entities","nrn":"organization=1","entity":"namespace","metadata":"tags","schema":{"type":"object","properties":{"my_string_property":{"type":"string","tag":true},"my_number_property":{"type":"number","default":0,"tag":"my_custom_tag_name"},"my_object_property":{"type":"object","properties":{"my_nested_property":{"type":"string"}}}},"required":["my_string_property"],"additionalProperties":false}}}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>