--- id: delete-account sidebar_label: Delete Account hide_title: true hide_table_of_contents: true api: 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 sidebar_class_name: "delete api-method" info_path: docs/api/beta/identitynow-beta-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 'Delete Account' (delete-account)" --- import ApiTabs from "@theme/ApiTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes"; 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 TabItem from "@theme/TabItem";

Delete Account

Use this API to delete an account. This endpoint submits an account delete task and returns the task ID. This endpoint only deletes the account from IdentityNow, not the source itself, which can result in the account's returning with the next aggregation between the source and IdentityNow. To avoid this scenario, it is recommended that you [disable accounts](https://developer.sailpoint.com/idn/api/v3/disable-account) rather than delete them. This will also allow you to reenable the accounts in the future. A token with ORG_ADMIN authority is required to call this API. >**NOTE:** You can only delete accounts from sources of the "DelimitedFile" type.** ## Request

Path Parameters

Async task details.
Schema
Client Error - Returned if the request body is invalid.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Schema
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 403 response object

Not Found - returned if the request URL refers to a resource or object that does not exist
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 404 response object

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Schema
Internal Server Error - Returned if there is an unexpected error.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 500 response object