---
title: "Delete A Registered Agent."
method: DELETE
path: "/v1/orchestrate/agents/{id}"
tags: ["Agents"]
---

# Delete A Registered Agent.

`DELETE /v1/orchestrate/agents/{id}`

Deletes a registered agent by id.

    
The knowledge-bases in general are sharable among agents, however in UI, this is not aparent.
Providing this flag keep_knowledge_bases for UI to set to false, in order to avoid "orphan" knowledge bases

## Path parameters

- `id` string, required

## Query parameters

- `keep_knowledge_bases` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/versions/82c114c37196/schema)
