> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Target Account

> Delete a target account by ID, name, or LinkedIn URL

At least one parameter is required.

**It removes only the entries you put there.** The target list has two sources:
entries added manually or by CSV, and entries a bound CRM list puts on it. A
company that is on the list only because of a bound list cannot be removed this
way, and answers `409 crm_row`, because the next nightly sync would add it
straight back.

Two ways to act on one of those: change the list in your CRM, or
[exclude the company](https://docs.clustr-ai.com/account-standing.md), which hides it everywhere while the
CRM list keeps it.

When both kinds of entry name the company, yours is removed and
`crm_rows_remaining` in the response says the company is still a target.

```bash cURL theme={null}
curl -X DELETE "https://api.clustr-ai.com/api/public/target-accounts?account_name=Acme%20Corp" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python Python theme={null}
import requests

requests.delete(
    "https://api.clustr-ai.com/api/public/target-accounts",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"account_name": "Acme Corp"},
)
```

```javascript JavaScript theme={null}
await fetch(
  "https://api.clustr-ai.com/api/public/target-accounts?account_name=Acme%20Corp",
  { method: "DELETE", headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "message": "Your own row is removed. A CRM list still puts this company on the target list",
    "deleted_count": 1,
    "crm_rows_remaining": 1
  }
}
```

```json 409 theme={null}
{
  "success": false,
  "error": {
    "message": "This company is on your target list because a CRM list puts it there. Exclude it instead, or change the list in your CRM",
    "code": "crm_row"
  }
}
```

```json 400 theme={null}
{
  "success": false,
  "error": {
    "message": "At least one of id, account_name, or linkedin_url is required",
    "code": "BAD_REQUEST"
  }
}
```

```json 401 theme={null}
{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}
```

```json 404 theme={null}
{
  "success": false,
  "error": {
    "message": "Target account not found",
    "code": "NOT_FOUND"
  }
}
```


## OpenAPI

````yaml DELETE /target-accounts
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /target-accounts:
    delete:
      tags:
        - Target Accounts
      summary: Delete Target Account
      description: >
        Delete a target account by ID, name, or LinkedIn URL. At least one
        parameter is required.
      operationId: deleteTargetAccount
      parameters:
        - name: id
          in: query
          schema:
            type: string
          description: Target account ID
        - name: account_name
          in: query
          schema:
            type: string
          description: The account name, matched exactly.
        - name: linkedin_url
          in: query
          schema:
            type: string
          description: The company's LinkedIn URL.
      responses:
        '200':
          description: Target account deleted
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: Target account deleted successfully
                      deleted_count:
                        type: integer
                        example: 1
        '400':
          description: No identifying parameter was sent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Invalid or missing API key
        '404':
          description: Target account not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            message:
              type: string
              example: Invalid request body
            code:
              type: string
              example: BAD_REQUEST
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.