---
id: provider-specification-update
title: "Update a provider specification"
description: "Update an existing provider specification"
sidebar_label: "Update a provider specification"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "patch api-method"
info_path: docs/api/providers
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 provider specification"}
>
</Heading>

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



Update an existing provider specification

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

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

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"title":"ProviderSpecificationUpdate","description":"Object to update a provider specification","properties":{"name":{"type":"string","description":"Name of the provider specification"},"icon":{"type":"string","description":"Icon for the provider specification"},"description":{"type":"string","description":"Description of the provider specification"},"visible_to":{"type":"array","items":{"type":"string"},"description":"List of NRNs this specification is visible to"},"schema":{"type":"object","description":"[JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification.\nThis schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations).\nIt can also include custom JSON Schema keywords such as:\n\n• **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.\n\n• **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed.\n\n• **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.\n"},"allow_dimensions":{"type":"boolean","description":"Flag to allow dimensions for this specification"},"default_dimensions":{"type":"object","description":"Default dimensions for the provider specification"},"category":{"type":"string","description":"Category slug to associate with this specification. Valid values: logging, metrics, cloud-providers, code-repository, assets-repository, container-orchestration, compute-management, vpc"}},"example":{}}}},"description":"Object to update a provider specification"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a provider specification resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","description":"Name of the provider specification"},"slug":{"type":"string","description":"Unique slug for the provider specification"},"icon":{"type":"string","description":"Icon for the provider specification"},"description":{"type":"string","description":"Description of the provider specification"},"visible_to":{"type":"array","items":{"type":"string"},"description":"List of NRNs this specification is visible to"},"schema":{"type":"object","description":"[JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification.\nThis schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations).\nIt can also include custom JSON Schema keywords such as:\n\n• **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.\n\n• **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed.\n\n• **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.\n"},"allow_dimensions":{"type":"boolean","description":"Flag to allow dimensions for this specification"},"default_dimensions":{"type":"object","description":"Default dimensions for the provider specification"},"tags":{"type":"array","description":"Tags associated with the providers","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"},"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}},"required":["key","value","id"],"additionalProperties":false}},"categories":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated categories"},"dependencies":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated dependencies"},"organization_id":{"type":"integer","nullable":true,"description":"Organization ID that owns this specification. NULL means global (nullplatform-managed)"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderSpecificationRead","description":"Object representing a provider specification resource","required":["id","name","slug","schema","allow_dimensions","created_at","updated_at"]}}}},"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>