Agent Versions
Delete an agent version
Deletes a specific version of an agent. For hosted agents, if the version has active
sessions, the request is rejected with HTTP 409 unless force is set to true. When
force is true, all sessions associated with this version are cascade-deleted.
Paramètres de chemin d’accès
agent_name
string
obligatoire
The name of the agent to delete.
agent_version
string
obligatoire
The version of the agent to delete
Paramètres de la requête
force
boolean
For Hosted Agents, if true, force-deletes the version even if it has active sessions, cascading deletion to all associated sessions. The service defaults to false if a value is not specified by the caller. This value is not relevant for other Agent types.
api-version
string
obligatoire
The API version to use for this operation.
Réponses
The request has succeeded.
Corps
object
enum
obligatoire
The object type. Always 'agent.version.deleted'.
name
string
obligatoire
The name of the agent.
version
string
obligatoire
The version identifier of the agent.
deleted
boolean
obligatoire
Whether the agent was successfully deleted.
Requête
DELETE /agents/{agent_name}/versions/{agent_version} HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json