---
id: provider-specification-delete
title: "Delete a provider specification"
description: "Delete an existing provider specification. Cannot delete if providers are using it."
sidebar_label: "Delete a provider specification"
hide_title: true
hide_table_of_contents: true
api: eJztWG1v2zYQ/isHflkSyHY3bF/0rahTzEWWBo2DFUiM4CyeZTYSqZKUU9cwsN+yn7ZfMhwpO1JsJ90bigH9ZEu6e+54fO6FXAlTkUWvjB5JkYrKmoWSZG9dRZmaqSx8SiUV5EkkwmPuRHotLho5uGzLiUkiJLnMqio8pmIYFAE10CflvNI5bExAx0QfXqHWxkM0BWq2FXSAlqB2rKx8XySiQoslebLsy0q4bE4linQlvPIFiVSMJPu6rPi/81bpXCRiZmyJXqSirhV/73p6pdXHmkBJ0l7NFFmYGQt+TsAv/BIsVZYcaU8S0AHC1dVoKNaJUKxeoZ+LRGgs2WbAt/SxVpakSL2taT1JhKOstsovg9dTQkv2Ze3nIr2e8GdLrjLakeOl/PD+Pf90nXw7/UCZf3CFQ4IHIgqWnKltxtuWGe1JewbEqioaicEHx6idAMaYmWBHJAKlVCyKxYVlpnjF3s2wcJQwWbavVrzmr7UDMeqrHXtd/HMsCcwsIO4PGWO5os6fx2p8ZeGtl4cxVRbj/DTmKDP6C8A6Ss9hDh+enl/6Qjk1LejWmxYwWotLkQjlqXS7Bh87JM6U82zq/N25Az9X7hErlYPGDngTAn6QfF3g6zeXb8/hMkhPjubeVy4dBAr3IkTf2HxgFmQXiu4H93P0PeV6LBC/Hz8T3P6NHgd/gzRImilNDhx5zjMXtFEv4VrXRVEV6JnOoLSnPFZQNzkaSJO5wbZyDVxdVcZ6kr223HH/Ro88ZKgBC2dA6ayoJUFWO29KaC0U7mh5b6x04OpsDujSG32j//jtdzg58ZifnMDR1JiCUB+n8AvaOxfrAeflMiRJ7U3PY57jtKAkPJboVYZFsYTMEjY1xGMO98rPN/EJAN85WGBRU//BqKPMkn/ebpRLgLSrmSh7cZkMmhZkwdKCsCDZspRbU1eOLQUKHqebXkMOMqNnKq9jOCFKBveVDobiFh5crqMs7AM04lej/k3IACwKc38rVUnasUCLlc1yd2j5usAcvIGgCg+qDdke8z8mzAzrwu+3c4D9w6iza+CphI7deieVu8hjzB2gcyZTyJW1zYLI4j3Zv/Wy2wPuaPl8TRpjzrQOFYdZ8GUaUZSL6dfqM+t2S78Oa92sIHg1ebJdsnqGnnJjm2AdLLBfo4U+akVDxzW8xYqW60G6Ii1JZ//HpXScXyfC2By1+hyy5rZhV3Q11GyyPNfVRcEVNM5yj228bSHAaAh+jh7Mvd7XAPtwfnV2BiWhdpAXZooFHLU7Sq9EjTnJY/YtlCySt+j3Zck2ghI99bwqaSeMr0LNMxr4q/NYVgxbV/KfwZ6h8xBR2shcc5ot35wQOgeEd4S7O/13h9p2MgYChTGwmeC2c8Weot4JaycYk/Wa1/Djvtn7dYhKYGHHVbLWWAcytrmXF6MwEliMLeYvDd9N6E4Z8SFhDtRa59HX7pWR7QKq63IaCNv1/efx+AKiAmRGEigtgx9NYw5rCHzrwj09/QatiBejMiNLOuPj3kPB+LztRtHIs+CXc2N9AvO6RN2zhJLzrrHFmsA2I3joISU5h/kXeD0kj6og2WA1eg3RAum21RvCnn3ygdH/Eg3adG3t3SYuDwtpSPjTNxJ+I+HXJWFYmJ8bvhnaXgGFm45UDPZfFQ1WSq65+pJdbO5naluIVGxObFipfrvf9TNTivbtSDj5RHq170i2kWWgTX0Pk3kQEknz5/Wme735dRxCp/TMtJl90Zpr2ccY0hf9F/3veSsr43yJISua25zNJdahSXvnTL5Ntv/o/qsJBJNjUBWoArNDlFfN9lwfuMkTiUjjqDo3zrPcajVFR1e2WK/59ceaLN9PTXi0tSrOPNcrIZXj/3J7+XNwyUfvGo4dwyFXN+OifpigUyGSeHzgXr6erBMxJ5Rkg/X44WWWUeVbKjuVjGm0Zezw9Ox0fMoDQJc/j/gSDOz1aLWKEmNzR3q93jro+Zl9XK//BAc7iUo=
sidebar_class_name: "delete 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={"Delete a provider specification"}
>
</Heading>

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



Delete an existing provider specification. Cannot delete if providers are using it.

<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={undefined}
>
  
</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>