---
title: "Update knowledge base"
method: PUT
path: "/knowledgeBase/{kbId}"
tags: ["Knowledge Base"]
---

# Update knowledge base

`PUT /knowledgeBase/{kbId}`

Update a knowledge base's name.

**Required permission:**

User must have one of `OWNER` or `WRITER` on the knowledge base.

**Validation:**

- `kbId` path parameter must be a valid UUID (`updateKBSchema`)
- When provided, `kbName` must be 1–255 characters
- XSS and format-specifier checks are applied to `kbName` in the gateway controller

## Path parameters

- `kbId` string, uuid, required

## Request body

- object
  - `kbName` string — New name for the knowledge base

## Response `200`

Knowledge base updated successfully

- UpdateKnowledgeBaseById — Response returned by PUT /knowledgeBase/{kbId} (updateKnowledgeBase).
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400` — Invalid request. Possible reasons: - `kbId` is not a valid UUID (gateway `updateKBSchema`) - `kbName` is empty or longer than 255 characters - `kbName` fails XSS or format-specifier validation in the gateway controller - Invalid JSON request body at the connector (`Invalid request body`) - Connector rejected the update payload
- `401` — Unauthorized — valid bearer token required
- `403` — Forbidden. Possible reasons: - OAuth token lacks the `kb:write` scope - User has no permission on this knowledge base - User role is insufficient (`READER`; requires `OWNER` or `WRITER`) - Connector service denied the request
- `404` — Not found. Possible reasons: - Knowledge base does not exist - Authenticated user does not exist in the graph database
- `500` — Internal server error — updating knowledge base failed in connector or database
- `503` — Service unavailable — connector service is unreachable

---

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