---
title: "Get knowledge base by ID"
method: GET
path: "/knowledgeBase/{kbId}"
tags: ["Knowledge Base"]
---

# Get knowledge base by ID

`GET /knowledgeBase/{kbId}`

Retrieve detailed information about a specific knowledge base.

**Overview:**

Returns complete KB metadata including name, timestamps, root-level folders, and the requesting user's role.

**Access Control:**

User must have at least READER permission to view KB details.

## Path parameters

- `kbId` string, required

## Response `200`

Knowledge base retrieved successfully

- GetKnowledgeBaseById — Response returned by GET /knowledgeBase/{kbId} (getKnowledgeBase).
  - `id` string, required — Knowledge base ID
  - `name` string, required — Knowledge base name
  - `connectorId` string, nullable, required — Associated connector ID (null for manual KBs)
  - `createdAtTimestamp` integer, required — Creation timestamp in milliseconds
  - `updatedAtTimestamp` integer, required — Last update timestamp in milliseconds
  - `createdBy` string, required — User ID of the creator
  - `userRole` 'OWNER' | 'WRITER' | 'READER', required — User's role in this knowledge base
  - `folders` object[], required — Root-level folders in this knowledge base
    - `id` string, required — Folder ID
    - `name` string, required — Folder name
    - `createdAtTimestamp` integer — Creation timestamp in milliseconds

## Other responses

- `401` — Unauthorized — valid bearer token required
- `403` — Forbidden. Possible reasons: - OAuth token lacks the `kb:read` scope - User does not have permission to access this knowledge base - 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 — retrieving 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)