---
id: scope-delete
title: "Remove a scope"
description: "Remove a scope by ID."
sidebar_label: "Remove a scope"
hide_title: true
hide_table_of_contents: true
api: eJzdVs1u20YQfpXBnBKDlZXEvvAQwE0c1EVRGImCBrCMYLQ7Ejchd5n9UaMKvPXe12lfpy/QVyhmKdGU7TTtoS1aH2h7ObvzzTffx50tag7KmzYaZ7HEl9y4NQNBUK5lWGzg4vkEC3Qte5KYC40l5pel5pojY4GRVgHLK3wly3hdYGCVvIkbLK+2uGDy7M9SrLC8uu6uC2zJU8ORfcgBlhrGEo3GAo2AaClWWKDnD8l41lhGn7i4hXRWMSRrPiSGi+ewdB5ixT1sARxUxQ1hucW4aeX4EL2xK+y6Ysi4dF7xPumHxH5zkHVJdeAC+SM1bc33o3ghR0DPxMCaWWYsnlepJr9/uyRTh8nczu1T+PXHX377+Sc4Orr0rJzVRo4LR0dz+1ReS23zHt5u9xzB5ZywYOUaDkBrMjUtagZn643kJGg9r41LYQAUIzdthO8pQLIhKcUhLFP9RwQVyDY10k6pF6876Zjn0DobOEj84+lUft1txyCSnHCcrivw5M2bu7ue1YZtBPbeeRiSgE4M0YGxa6qNBmPbFMF5aEwIxq7gRkBSiXI2so1yOrVtbVTGcPwuSIrt3ULd4h2reNDqKwyRYgrPnBZBZDxYYMMh0CpLuvVSXTQ9BaPom3ONjbxi2XdY5Fez2SX0O0A5LcJoPQe2UWrJqm1ZmaVRoMZ8PODJalLAyXQqj0fyeCKPk4dS9SDLk+m0ExIOsAzNPIRyBg2pylj+wjPprJ4+V8YVK4qgKPLKefMDhx4b+zX7rN7k+SAzLki/FRI5RGlxT9ufALHwhpcFVKkhe4NkFAWut1APTo7bszHHL0nDyz7pHGXhtaUUqwxZz/GQnHG0QNx39PMgdW9KqkFzFOsCLVyKN7AO88yy4XOerP6G6qXzDWvI7NpIxrIeJD1WcJd/Cjy9zyGvevpvO8RYnXVuV0AWTAhJvgMZ3NnlBQSj+X9mjTAmYieGU7HG6fSxPJ4cNv7033OFFOst1W/7oLc9Zf+YPy526WEnnXOJ6Z0iK0YxvLbD7XHHMPdu/1utc2YhWf7YsoqsdyU5pZL3rCdwWTMFhug3QCsyFmqK7Peuybhi5WQqGeaRPD+UeJxv4+Ot0Z3cd7mcfuJIvsYSqxjbUB4fU2smNtV1W1MUz06Ua7AbjTGvxCa9usfDzMCDHLS/UfNnMQdhsfvjhfMNRSzx6+9mMn+gsUsn2wVPT9mjyXQylUnKxEzJtyM4Ymjhv3UhNpR9u5tfDoe1233Y3rj/k2PdroDIH+NxW5Oxkiizs92xeIX7w0ujxe2VC1GWt9sFBX7t666T5X58EnK1CSKsmwHqk6j+u8PTvby9581oqFxTnSQmK2lN3ki6v0jQg5e7z/BD+My4ey+g3SLZzRjPHqjR2F13BVZMmn1G1r84U4rbONpy5+qQkgbbPT//5nx2jgXSoStuuSAnuBfRdttHzNx7tl03AIzyv2Dsut8BsstgxA==
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={"Remove a scope"}
>
</Heading>

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



Remove a scope by ID.

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

<ParamsDetails
  parameters={[{"name":"id","in":"path","required":true,"description":"The unique ID for the scope.","schema":{"type":"string"}},{"name":"force","in":"query","required":false,"example":true,"description":"Force delete a scope if the regular delete fails.\n\n> ℹ️ **Preconditions**\n>\n> The \"force delete\" option becomes available only if a previous delete attempt was unsuccessful.","schema":{"type":"string","enum":["true"]}}]}
>
  
</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>