---
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"},"package_revision_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"The package revision the service is currently running, or `null` when it isn't running one. The agent that applies a revision records it here"},"desired_package_revision_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"The package revision the service should move to. While it is set, the service's specification and its action specifications resolve against this revision instead of `package_revision_id`. When an action on the service succeeds, this revision becomes `package_revision_id` and this field is cleared. `null` when no move is pending"},"parent_service_id":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"null"}],"description":"The parent service of this service. `null` for top-level services"}},"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>