Delete Agentic Avatar
DELETE
/v1/agentic-avatars/{agentic_avatar_id}Delete a user-owned agentic avatar.
About Agentic Avatar Deletion
Deleting an agentic avatar permanently removes it from your account. This action will:
- Remove the agentic avatar configuration
- Prevent the avatar from being used in new widget sessions
- Not affect existing widget sessions that are already active
- Not delete the underlying avatar, voice, or brain (knowledge base) - only the agentic avatar configuration
Request History
Log in to see full request history
| TIME | STATUS | USER AGENT |
|---|---|---|
| Make a request to see history. | ||
0 Requests This Month
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| agentic_avatar_id | string | The unique identifier of the agentic avatar to delete. This is the same id returned when creating or retrieving the agentic avatar. |
Request Example
shell
curl -X DELETE https://api.konpro.ai/v1/agentic-avatars/{agentic_avatar_id} \
-H "x-api-key: <your-api-key>" \
-H "Content-Type: application/json"Response
| Field | Type | Description |
|---|---|---|
| message | string | Success message confirming the agentic avatar deletion (e.g., "Agentic avatar deleted successfully") |
| id | string | The unique identifier of the deleted agentic avatar |
Sample Successful Response
json
{
"message": "Agentic avatar deleted successfully",
"id": "72e527cd-9d40-47a7-8c9d-753f945a7574"
}Notes
- This endpoint requires authentication using the
x-api-keyheader. - Replace
{agentic_avatar_id}in the URL with the actual agentic avatar ID you want to delete. - You can only delete agentic avatars that you own.
- This action is permanent and cannot be undone. The agentic avatar configuration cannot be recovered after deletion.
- Deleting an agentic avatar does not delete the underlying avatar, voice, or brain (knowledge base). These remain available for use in other agentic avatars or directly.
- Active widget sessions using this agentic avatar will continue to function until they expire or are terminated, but new sessions cannot be created with the deleted agentic avatar.
- If you need to use the agentic avatar again after deletion, you'll need to create a new one using the Create Agentic Avatar endpoint.
- For error descriptions, see Error Responses.