Delete All Agent Corpus Connections

DELETE

/v2/api/agent/{agent_id}/corpus

Deletes all corpus connections associated with a specific agent, except for the default corpus connection, which remains intact to ensure the agent retains minimal functionality.

Once executed:

All non-default corpus links will be permanently removed.

The agent will no longer be able to retrieve or interact with data from the removed corpora.

Any features or workflows dependent on those connections may be impacted.

Required path parameter:

agent_id: The unique identifier of the agent whose non-default corpus connections are to be deleted.

Purpose of Agent ID

The Agent ID is essential for:

Identifying specific agents when making API requests.

Managing and modifying agent configurations.

Fetching agent-related data efficiently.

How to View Your Agent ID?

To find your agent's Agent ID, follow the step-by-step guide here:
View Your Agent ID

For more detailed information about agent, refer to the Agent Guide

📝 Note: "Assistant" is another name for "Agent".

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request DELETE 'https:///v2/api/agent/1253/corpus' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "message": "All corpuses of agent have been deleted except default one"
}

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Successfully deleted all agent corpus connections except the default one.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Get All Agent Corpus Connections

Create Agent Response

Delete All Agent Corpus Connections

Purpose of Agent ID#

How to View Your Agent ID?#

Request

Responses

Purpose of Agent ID

How to View Your Agent ID?