---
id: namespace-delete
title: "Delete a namespace"
description: "Deletes a specific namespace by its ID. This action **cannot be undone**."
sidebar_label: "Delete a namespace"
hide_title: true
hide_table_of_contents: true
api: eJzdVk1v4zYQ/SuDOe0GquN8XXTLblI0RVEEGwddIA6CMTm2uEuRWpJykxr678VQji3bQdtLW2B9oCVxyHl8M48zK9QcVTBNMt5hiVdsOXEEgtiwMnOjwFHNsSHFMHsBkyLcXI1gUpkIpGQVHB0pcs4nmDG0TnvHR0ejqZu6siyNm/up+8BzHxi0bG7cAmi7aQHsYhsYUkUJyFqgGL0ylFgDNY01isRLBHIaIoelURyhoiXDjNn1m7IeZXdYoG845BU3Gkvc+Cl7Oyww0SJi+YC/vk7hY4ENBao5cZCpFRrhoqFUYZG3wBKNxgKjqrgmLFeYXpr81SVecMCuwMDfWhNYY5lCy8UesZOK4eYK/BxSxdvjj7BAfqa6sYzlyenZ+UX3WGBk1QaTXjKWGVPgcNmmCsuHR5kOHBvvIkcBcjoey9+htw0R8DtFiK1SHOO8tSMBe/758+Gqj9awS8Ah+AAbJ6BbhuTBuCVZo8G4pk3gA9QmRonmljs5jfIusUuy+yB8x1+iuFgdMuhnX1glHPL3gDFRauNHryVgGQ8WWHOMtOjDFeR0yfQUDKwPI7MfiJ8mk1voV4DymiFwEziyy5kpwdlkvhry8Y5Hi1EB5+OxDCcynMlw/n4nhufjcSck7GCJKRi3OIByCTWpyjj+ITBpmlle+8q4siAUJV74YP7g2GPjsOQAczK2DbvZgzPST0IixyQh7mn7ByBmwfC8gKqtyW2RDKxes7YHJ9u9sjHFD6ThU+90ivLh3lGbqgxZT3GXnKG1QHyN6N+D1NrII1nQnMjYCDTzbdrC2vUj+b+mImd/TXbuQ80aMrsukXGsNyk9zOAu/wq8eEshdz39+woxTuc8l6vNgYmxZfAug7u8vYFoNH9n0ohDItbJcCHSuBifynC2G/iL/08VctjgyD71Rk89Zf+ZPm7W7mGdOtdi0yvlri9mcO9oScbKrgeCeXP5vyqdSwet4+eGlVTg/kheqTYE1iO4tUyRIYUXoAUZB5YSh1fVZFyp8lJ5N/U2l9ESjzc173hldCfFNB+pL7htsFhilVITy+NjaszItdY2lpLodqR8jcPCeCdS6TN8WB43XMhGr+U6X43ZCIv1w48+1JSwxJ9/m6CgljZFlguenraT0Xg0lm7BpEzLtlvoCmx8TDVl0a67g75vGjY2+4FYbeX/HXRZa54TP6fjxpJxQksO4mod8AccUlEaLZdT5WOSqdVqRpHvg+06+fyt5SDNzmOBSwpGlJCzQpsozxrLOdm431MNGX33aX1Fvoe/6LTeRL3+SO4Fxb1t5Q0L/MovfdvXPXYFVkyaQ0bVT1wqxU0aLDm40iVhN3K4uv7lenKNBdJupu5lZnbwJqLVqreY+K/sum4DMMm7YOy6PwGbXxLE
sidebar_class_name: "delete api-method"
info_path: docs/api/namespace
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 namespace"}
>
</Heading>

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



Deletes a specific namespace by its ID. This action **cannot be undone**.

:::info
Before deleting a namespace, ensure that all associated applications and services have been deleted.
:::

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the namespace.","example":12345}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful."},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>