---
title: "Create collection"
method: POST
path: "/beta/knowledge/collections"
tags: ["Knowledge"]
---

# Create collection

`POST /beta/knowledge/collections`

## Request

- Base URL: `https://dev.dixa.io`
- URL: `https://dev.dixa.io/beta/knowledge/collections`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/dixa/apis/dixa-api/docs/beta/knowledge/collections/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a knowledge collection

## Request body

- CreateKnowledgeCollectionInput
  - `title` string, required: Title of the collection
  - `description` string: Description of the collection
  - `internalKbEnabled` boolean: Whether the collection is available to browse in the internal knowledge base. Defaults to true

## Response `200`

The created knowledge collection

- CreateKnowledgeCollectionOutput
  - `data` Collection, required
    - `id` string, required
    - `title` string, required
    - `description` string
    - `internalKbEnabled` boolean, required
    - `restrictions` Restrictions, required
      - `isRestricted` boolean, required: Whether a restriction is set directly on this item. The only restriction is internal use: the content is available only to logged-in users
      - `inheritedRestrictions` InheritedRestriction[]: Restrictions inherited from parent collections or categories. When several parents have the same restriction, only the top-most parent is listed
        - `fromCollection` string: ID of the collection the restriction is inherited from. Empty if it comes from a category
        - `fromCategory` string: ID of the category the restriction is inherited from. Empty if it comes from a collection

## Other responses

- `400`
- `500`: Internal failure during request processing

## Changes

- **2026-10-19** `2d55af7340b9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dixa/apis/dixa-api/changes/beta/knowledge/collections/post.md)

---

[API](https://skmtc.dev/dixa/apis/dixa-api.md) - [All operations](https://skmtc.dev/dixa/apis/dixa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dixa/apis/dixa-api/revisions/4c9e4ef864d1?raw)