Back to API List

Delete a Contact API

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.
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

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

{
    "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

Send Feedback