---
title: "Add Root"
method: POST
path: "/v1/knowledge-base/knowledge-bases/{kb_id}/sources/{source_id}/roots"
tags: ["knowledge-base-connectors"]
---

# Add Root

`POST /v1/knowledge-base/knowledge-bases/{kb_id}/sources/{source_id}/roots`

Add a root to a connector source (Notion page id, a URL, an S3 key, or a Drive file).

## Path parameters

- `kb_id` string, uuid, required
- `source_id` string, uuid, required

## Request body

- CreateRootRequest
  - `provider_item_id` string, nullable
  - `url` string, nullable
  - `s3_path` string, nullable
  - `resource_key` string, nullable
  - `shortcut_target_resource_key` string, nullable

## Response `201`

Successful Response

- RootResponse
  - `id` string, uuid, required
  - `knowledge_base_source_id` string, uuid, required
  - `provider_item_id` string, required
  - `item_type` string, required
  - `display_name` string, required
  - `source_url` string, nullable
  - `is_recursive` boolean
  - `metadata` object, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.dev/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/9cd7291d4228/schema)