> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Contact API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/contact-center/api-list)</Badge>

Use this API to delete a specific contact by ID.

| **Method**        | DELETE                                                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Endpoint**      | `https://{{host}}/agentassist/api/v1/public/{{streamId}}/contacts/{{id}}`                                                      |
| **Content Type**  | `application/json`                                                                                                             |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction#generating-the-jwt-token) |
| **API Scope**     | Configuration                                                                                                                  |

## Path Parameters

| Parameter  | Description                                                                 | Type             |
| ---------- | --------------------------------------------------------------------------- | ---------------- |
| `host`     | Environment URL, for example, `https://platform.kore.ai`                    | string, required |
| `streamId` | BotId or StreamId. You can access it from the App Settings page of the bot. | string, required |
| `id`       | The unique identifier of the contact.                                       | string, required |

## Sample Request

```bash theme={null}
curl --location --request DELETE 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/contacts/{{id}} \
--header 'Content-Type: application/json' \
--header 'accountId: {{accountId}}' \
--header 'auth: {{jwt_token}}'
```

## Request Headers

| **Header**     | **Description**                                                                          | **Required/Optional** |
| -------------- | ---------------------------------------------------------------------------------------- | --------------------- |
| `auth`         | JWT token for authentication.                                                            | required              |
| `accountId`    | The account ID associated with the API request.                                          | required              |
| `Content-Type` | The format in which the request payload is sent to the server. Example: application/json | required              |

## Sample Response

```json theme={null}
{
    "firstName": "john",
    "lastName": "doe",
    "fullName": "john doe",
    "salutation": "mr",
    "cellPhone": {
        "extension": "+",
        "phoneNumber": "+9124456xxxxx",
        "countryCode": "+91"
    },
    "status": "INACTIVE",
    "instanceBotId": "st-7dc994f0-4436-5134-9fa8-a942625xxxxx",
    "orgId": "o-16ff21d2-5d27-5fb2-b9bd-9fedb5fxxxxx",
    "accountId": "65f7d49a5dd06e2cefaxxxxx",
    "createdBy": "u-cc6ebd6c-656c-5364-abfc-ad5f80exxxxx",
    "createdByAId": "a-6c63a33-c2a7-49e8-a5ab-82449c8xxxxx",
    "address": [],
    "twitterDetails": [],
    "createdAt": "2026-01-09T05:20:39.374Z",
    "updatedAt": "2026-01-09T09:19:37.307Z",
    "id": "69609027c1746a61429xxxxx"
}
```

## Response Parameters

| Parameter               | Description                                                   | Type                        |
| ----------------------- | ------------------------------------------------------------- | --------------------------- |
| `firstName`             | Contact's first name.                                         | string                      |
| `lastName`              | Contact's last name.                                          | string                      |
| `fullName`              | Contact's full name.                                          | string                      |
| `salutation`            | Salutation or title of the contact.                           | string                      |
| `cellPhone`             | Mobile details of the contact.                                | object                      |
| `cellPhone.extension`   | Dialing prefix.                                               | string                      |
| `cellPhone.phoneNumber` | Contact's mobile phone number.                                | string                      |
| `cellPhone.countryCode` | Country calling code associated with the phone number.        | string                      |
| `status`                | Current status of the contact. For example, inactive.         | string                      |
| `instanceBotId`         | Unique identifier of the associated bot instance.             | string                      |
| `orgId`                 | Unique identifier of the organization.                        | string                      |
| `accountId`             | Unique identifier of the account.                             | string                      |
| `createdBy`             | Unique identifier of the user who created the contact.        | string                      |
| `createdByAId`          | Unique identifier of the application that created the record. | string                      |
| `address`               | List of addresses associated with the contact.                | array of objects            |
| `twitterDetails`        | List of Twitter profile details associated with the contact.  | array of objects            |
| `createdAt`             | Timestamp indicating when the contact was created.            | string (ISO 8601 Date-Time) |
| `updatedAt`             | Timestamp indicating when the contact was last updated.       | string (ISO 8601 Date-Time) |
| `id`                    | Unique identifier of the contact record.                      | string                      |