---
id: service-delete
title: "Delete a service"
description: "Delete a service"
sidebar_label: "Delete a service"
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"}
>
</Heading>

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



Delete a service

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

<ParamsDetails
  parameters={[{"schema":{"type":"boolean","default":false},"in":"query","name":"force","required":false,"description":"Specifies whether to force delete the service. If set to true, the service will be deleted without checking for delete action existence"},{"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 instances","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,"maxLength":255,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"maxLength":255,"not":{"enum":[null]},"description":"Slug of the entity. Automatically generated from \"name\""},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"desired_specification_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"Desired unique identifier for the associated specification"},"messages":{"title":"Message","type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["debug","info","information","warn","warning","error","fatal"],"default":"info","description":"Message severity level. Defaults to \"info\""},"message":{"type":"string","description":"The actual message content"},"timestamp":{"type":"number","description":"Timestamp of the message in milliseconds"}},"required":["message"],"additionalProperties":false,"description":"Object representing messages with severity levels"}},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"archived_at":{"type":"string","format":"date","nullable":true,"description":"When the instance was last archived. `null` while the instance is not archived"},"status":{"type":"string","enum":["pending_create","pending","creating","updating","archiving","active","archived","failed","cancelled"],"description":"Status of the service. Should be one of the specified values in the enumeration"},"linkable_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"}},"dimensions":{"title":"Dimension","type":"object","additionalProperties":{"type":"string","minLength":1,"maxLength":100,"not":{"enum":[null]},"description":"Key-value pairs representing dimensions. Each key must be a non-null string with a minimum length of 1"},"description":"Object representing dimensions with key-value pairs"},"attributes":{"type":"object","description":"Attributes associated with the service, should be valid against the service specification attribute schema"},"entity_nrn":{"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"},"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. Should be one of the specified values in the enumeration"}},"description":"Object representing service instances","additionalProperties":false,"title":"Service","example":{"name":"my-service","entity_nrn":"organization=1:account=1:namespace=1","specification_id":"67fac146-54cc-466d-8c52-a8234445a95f","linkable_to":["organization=1:account=1","organization=1:account=2"],"attributes":{"my_string_property":"my_string_value","my_number_property":0}}}}}},"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>