> ## 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 an excluded title

> Remove one excluded title

Removes one [excluded title](https://docs.clustr-ai.com/buyer-titles.md). The people it hid appear again
within seconds.

## Errors

| Status | Code | When |
| - | - | - |
| 400 | `BAD_REQUEST` | The id is not a number |
| 404 | `NOT_FOUND` | No such excluded title in this workspace |

```bash cURL theme={null}
curl -X DELETE https://api.clustr-ai.com/api/public/excluded-titles/kwx_x1jkn5gxamtg8gfa5k2b3er0py \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "data": { "message": "Exclusion deleted" }
}
```


## OpenAPI

````yaml DELETE /excluded-titles/{id}
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:
  /excluded-titles/{id}:
    delete:
      tags:
        - Buyer Titles
      summary: Delete an excluded title
      description: >
        Remove one excluded title. The people it hid appear again within
        seconds.
      operationId: deleteExcludedTitle
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
          description: >-
            The title's Clustr ID (`kwx_…`), from [List excluded

            titles](/api-reference/list-excluded-titles). The `id` from earlier
            responses also works.
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteJobTitleResponse'
        '400':
          description: The id is not a number
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Invalid or missing API key
        '404':
          description: No such excluded title in this workspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    DeleteJobTitleResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: object
          properties:
            message:
              type: string
    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.