---
title: "Toggle activation of a knowledge base item for a voice agent."
method: POST
path: "/v1/voice-agents/knowledge-base/toggle-activation"
---

# Toggle activation of a knowledge base item for a voice agent.

`POST /v1/voice-agents/knowledge-base/toggle-activation`

## Request body

- ToggleKBItemActivationRequest
  - `voiceAgentId` string, required — The voice agent ID to toggle the activation of the knowledge base item on.
  - `knowledgeBaseItemId` string, required — The knowledge base item ID to toggle the activation of.
  - `isActive` boolean — The value of isActive to toggle the activation of the knowledge base item. True to activate, false to deactivate. Defaults to true.

## Response `200`

Successful response

- object
  - `success` boolean
  - `message` string
  - `messageKey` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Server Side Error

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)