Delete ICP

curl --request DELETE \
  --url https://api.example.com/api/v1/entities/icps/{id} \
  --header 'Authorization: Bearer <token>'

DELETE

api

entities

icps

{id}

Delete ICP

curl --request DELETE \
  --url https://api.example.com/api/v1/entities/icps/{id} \
  --header 'Authorization: Bearer <token>'

Permanently deletes an ICP (Ideal Customer Profile) by its unique identifier. This action cannot be undone.

Deleting an ICP is a permanent action. All associated configuration, including lead provider criteria, custom filters, and CRM filters will be permanently removed. Lead lists that were generated from this ICP will remain but will no longer be associated with the deleted ICP.

Authentication

This endpoint requires authentication. The user must be signed in.

Users can only delete ICPs where they are listed in the userIds array, or if they are an admin user. Attempting to delete an ICP without proper authorization will result in a 403 Forbidden error.

Request

string

required

The unique identifier (UUID) of the ICP to delete.

Response

Returns an empty response with HTTP status 204 (No Content) on successful deletion.

Response Examples

Error Codes

Status Code	Error Code	Description
204	-	ICP successfully deleted. No response body.
401	`UNAUTHORIZED`	User is not authenticated. Ensure a valid session exists.
403	`FORBIDDEN`	User does not have access to this ICP.
404	`NOT_FOUND`	No ICP exists with the specified ID.
500	`INTERNAL_ERROR`	An unexpected server error occurred.

​Authentication

​Request

​Response

​Response Examples

​Error Codes

Authentication

Request

Response

Response Examples

Error Codes