---
id: service-specification-delete
title: "Delete a service specification"
description: "Delete a service specification"
sidebar_label: "Delete a service specification"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "delete api-method"
info_path: docs/api/nullplatform-api
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 service specification"}
>
</Heading>

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



Delete a service 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={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing service specifications","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","minLength":1,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"not":{"enum":[null]},"description":"Slug of the specification. Automatically generated from \"name\""},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"visible_to":{"title":"Visibility","type":"array","description":"Array representing visibility settings for the entity. Specifies what/who can see this entity","items":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"}},"attributes":{"title":"Attribute","type":"object","properties":{"schema":{"type":"object","default":{},"description":"Specification of the attribute schema. Must be a valid JSON Schema"},"values":{"type":"object","default":{},"description":"Values associated with the attribute. Must validate against provided schema"}},"required":["schema","values"],"propertyNames":{"enum":["schema","values"],"description":"Allowed property names"},"additionalProperties":false,"description":"Object representing an attribute with a schema and associated values"},"selectors":{"title":"Selector","type":"object","properties":{"imported":{"type":"boolean","default":false},"provider":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"category":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"sub_category":{"type":"string","minLength":1,"maxLength":100,"default":"any"}},"additionalProperties":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"description":"Key-value object representing instance selectors"},"type":{"type":"string","enum":["dependency","scope"],"description":"Type of the service specification. Should be one of the specified values in the enumeration"},"dimensions":{"title":"Specification Dimension","type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"required":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"required":["required"]}},"scopes":{"title":"Specification Scope","type":"object","properties":{"provider":{"type":"object","properties":{"values":{"type":"array","items":{"oneOf":[{"type":"string","enum":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","AWS:WEB_POOL:EKS","AZURE:WEB_POOL:AKS","GOOGLE:WEB_POOL:GKE","OCI:WEB_POOL:OKE"]},{"type":"string","format":"uuid","description":"UUID of a scope specification"}]},"minItems":1}},"additionalProperties":false,"required":["values"]}},"additionalProperties":false},"assignable_to":{"type":"string","enum":["any","dimension","scope"],"description":"Specifies if the service can be assigned to any entity, only dimensions, or only scopes."},"use_default_actions":{"type":"boolean","description":"Specifies if the service specification should autogenerate its create, update, and delete actions from the attributes schema. When omitted on create, the default is true for every type except `scope`"},"use_default_naming":{"type":"boolean","description":"When true, the instance name is optional and generated by nullplatform or taken from the schema's `name` property. When false, a caller-provided name is required. Defaults to true for new specifications"}},"description":"Object representing service specifications","additionalProperties":false,"title":"ServiceSpecification","example":{"name":"my-service-specification","visible_to":["organization=1:account=1","organization=1:account=2"],"dimensions":{"environment":{"required":true,"values":["production","staging"]}},"scopes":{"provider":{"values":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","uuid-of-a-specific-scope-specification"]}},"assignable_to":"any","attributes":{"schema":{"type":"object","properties":{"my_string_property":{"type":"string"},"my_number_property":{"type":"number","default":0}},"required":["my_string_property"]},"values":{}}}}}}},"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>