---
id: delete-user
sidebar_label: Deletes an existing User.
hide_title: true
hide_table_of_contents: true
api: {"operationId":"deleteUser","tags":["Users"],"description":"The endpoint used to delete a User resource. **This is not reversible.**","parameters":[{"name":"userId","in":"path","schema":{"type":"string","example":"c7c7777c7ef77e77777ee77e7a1f0444"},"description":"The id of User resource. If **lookupByName** is set to **true**, this path parameter should be set to the **userName** of the User.","required":true},{"in":"query","name":"lookupByName","schema":{"type":"boolean","example":false,"default":false},"description":"A boolean value that determines if the User resource will be looked up by userName instead of userId (value in path parameter 'userId'). Setting this query parameter to true will cause the value pulled from the 'userId' path parameter to be treated as a userName when searching for the resource.<br/><br/>**Example**: scim/v2/Users/**Mock.User**?**lookupByName=true**"}],"responses":{"204":{"description":"Returns a 204 with no response body if delete was successful."}},"method":"delete","path":"/Users/{userId}","servers":[{"url":"http://localhost:8080/identityiq/scim/v2","description":"IdentityIQ SCIM server basepath and path to API."}],"security":[{"basicAuth":[]}],"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}},"info":{"description":"IdentityIQ REST Endpoint Interface Documentation for SCIM\n","version":"8.3","title":"IdentityIQ SCIM REST API"},"postman":{"name":"Deletes an existing User.","description":{"content":"The endpoint used to delete a User resource. **This is not reversible.**","type":"text/plain"},"url":{"path":["Users",":userId"],"host":["{{baseUrl}}"],"query":[{"disabled":false,"description":{"content":"A boolean value that determines if the User resource will be looked up by userName instead of userId (value in path parameter 'userId'). Setting this query parameter to true will cause the value pulled from the 'userId' path parameter to be treated as a userName when searching for the resource.<br/><br/>**Example**: scim/v2/Users/**Mock.User**?**lookupByName=true**","type":"text/plain"},"key":"lookupByName","value":""}],"variable":[{"disabled":false,"description":{"content":"(Required) The id of User resource. If **lookupByName** is set to **true**, this path parameter should be set to the **userName** of the User.","type":"text/plain"},"type":"any","value":"","key":"userId"}]},"method":"DELETE"}}
sidebar_class_name: "delete api-method"
info_path: iiq/api/identityiq-scim-rest-api
custom_edit_url: "https://github.com/sailpoint-oss/developer.sailpoint.com/issues/new?assignees=&labels=&template=bug-report.md&title=%5BBug%5D+Your+Bug+Report+Here Requesting changes to 'Deletes an existing User.' (delete-user)"
---

import ApiTabs from "@theme/ApiTabs";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import TabItem from "@theme/TabItem";

## Deletes an existing User.



The endpoint used to delete a User resource. **This is not reversible.**

<details style={{"marginBottom":"1rem"}} data-collapsed={false} open={true}><summary style={{}}><strong>Path Parameters</strong></summary><div><ul><ParamsItem className={"paramsItem"} param={{"name":"userId","in":"path","schema":{"type":"string","example":"c7c7777c7ef77e77777ee77e7a1f0444"},"description":"The id of User resource. If **lookupByName** is set to **true**, this path parameter should be set to the **userName** of the User.","required":true}}></ParamsItem></ul></div></details><details style={{"marginBottom":"1rem"}} data-collapsed={false} open={true}><summary style={{}}><strong>Query Parameters</strong></summary><div><ul><ParamsItem className={"paramsItem"} param={{"in":"query","name":"lookupByName","schema":{"type":"boolean","example":false,"default":false},"description":"A boolean value that determines if the User resource will be looked up by userName instead of userId (value in path parameter 'userId'). Setting this query parameter to true will cause the value pulled from the 'userId' path parameter to be treated as a userName when searching for the resource.<br/><br/>**Example**: scim/v2/Users/**Mock.User**?**lookupByName=true**"}}></ParamsItem></ul></div></details><div><ApiTabs><TabItem label={"204"} value={"204"}><div>

Returns a 204 with no response body if delete was successful.

</div><div></div></TabItem></ApiTabs></div>