Create a collection

Understanding how to use FeatureOS API to build custom integrations.

Introduction

The FeatureOS create collection API allows you to create a new collection in your knowledge base.

POST https://api.featureos.app/api/v3/collections

curl -X POST 'https://api.featureos.app/api/v3/collections' \
  -H 'API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json'

const response = await fetch('https://api.featureos.app/api/v3/collections', {
  method: 'POST',
  headers: {
    'API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

import requests

response = requests.post(
    'https://api.featureos.app/api/v3/collections',
    headers={
        'API-KEY': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
)
data = response.json()

Headers

Parameter	Default	Description
API-KEY	-	Generate from organization settings on the admin dashboard.
Authorization	-	Generate a unique JWT token specific to a user.

Body Parameters

Parameter	Required	Format	Description
name	true	String	The name of the collection.
description	false	Text	A description of the collection.
privacy	false	String	The collection privacy: `public` or `private`. Defaults to `public`.
parent_id	false	Integer	The ID of a parent collection to nest under.
icon	false	String	URL to a custom icon for the collection.

Sample response

{
  "id": 25,
  "slug": "integrations",
  "color": "default",
  "description": "How to connect FeatureOS with your favorite tools.",
  "icon": null,
  "kind": "category",
  "name": "Integrations",
  "published_articles_count": 0,
  "published_articles_count_with_children": 0,
  "read_only": false,
  "sub_categories_count": 0,
  "created_at": "2025-01-15T10:00:00.000Z",
  "updated_at": "2025-01-15T10:00:00.000Z",
  "parent_id": null,
  "user_id": 123,
  "privacy": "public",
  "position": 11,
  "seo_title": null,
  "seo_description": null
}