# Knowledge Base Endpoints {#knowledge-base-endpoints}


Manage knowledge base articles and categories.


## Base Path {#base-path}


```
/api/knowledge-base
```


## Article Endpoints {#article-endpoints}



### List Articles {#list-articles}


```
GET /api/knowledge-base/article
Authorization: Bearer {token}
```


### Create Article {#create-article}


```
POST /api/knowledge-base/article
Authorization: Bearer {token}
```

```json
{
  "name": "How to Track Time",
  "data": "<h1>Time Tracking Guide</h1><p>Follow these steps...</p>",
  "categoryId": "category-uuid",
  "privacy": "PUBLIC",
  "index": 1
}
```


### Update Article {#update-article}


```
PUT /api/knowledge-base/article/:id
Authorization: Bearer {token}
```


### Delete Article {#delete-article}


```
DELETE /api/knowledge-base/article/:id
Authorization: Bearer {token}
```


## Category Endpoints {#category-endpoints}



### List Categories {#list-categories}


```
GET /api/knowledge-base/category
Authorization: Bearer {token}
```


### Create Category {#create-category}


```
POST /api/knowledge-base/category
Authorization: Bearer {token}
```

```json
{
  "name": "Getting Started",
  "description": "Beginner guides",
  "icon": "book-outline",
  "color": "#3366FF"
}
```


## Article Privacy {#article-privacy}


| Value   | Description       |
| ------- | ----------------- |
| PUBLIC  | Visible to all    |
| PRIVATE | Organization only |


## Related Pages {#related-pages}


- [Knowledge Base](https://sourcey-gauzy.pages.dev/features/knowledge-base/index.md) — feature guide
- [Help Center](https://sourcey-gauzy.pages.dev/features/help-center/index.md) — help center