Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.runorion.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect external documentation sources to pull content directly into your Knowledge Base.

Notion
Import pages and databases using a Notion integration token

Confluence
Browse spaces and pages using your Atlassian email and API token

GitHub
Import markdown, text, and Word files from any accessible repository

Adding an Integration

Integrations are managed by admins at the workspace level under Configuration.
  1. Go to Configuration in the left-hand navigation
  2. Select the Knowledge Base tab
  3. Find the integration type (GitHub, Confluence, or Notion)
  4. Click + Add connection and enter your credentials
  5. Save — Orion validates the connection before storing it
Configuration > Knowledge Base tab showing GitHub, Confluence, and Notion integrations with existing connections and Add connection buttons
Once connected, the integration appears in the list with the connection name and date. Each connection can be renamed (pencil icon), browsed (link icon), or deleted (trash icon).
Only admins can add integrations. Connected integrations are available to all users for browsing and importing content.

Notion

Setup

Create a Notion internal integration for your workspace, then click + Add connection next to Notion in Configuration → Knowledge Base:
  1. Enter your Integration Token (starts with secret_)
  2. Give the connection a name
  3. Save — Orion validates the token before storing it
You must explicitly share each Notion page or database with the integration inside Notion before Orion can access it (ShareConnections → select your integration).

What You Can Import

  • Pages — Imported as markdown with full formatting preserved
  • Databases — Rendered as markdown tables with all visible properties
  • Child pages — Browse into a page to see nested child pages and sub-databases

Browsing

The root level shows all pages and databases shared with your integration. Click into a database to see its rows, or into a page to see child pages.
If a page isn’t showing up, check that you’ve shared it with the integration in Notion’s Connections settings.

Confluence

Setup

Generate a Confluence API token from your Atlassian account, then click + Add connection next to Confluence in Configuration → Knowledge Base:
  1. Enter your Base URL (e.g. https://yourcompany.atlassian.net)
  2. Enter the Email associated with your Atlassian account
  3. Enter your API Token
  4. Give the connection a name and save

What You Can Import

  • Spaces — Browse all available Confluence spaces
  • Pages — Navigate root pages in a space, then drill into child pages
  • Page content — HTML is automatically converted to markdown on import

Browsing

The root level lists all spaces your token can access. Navigate into a space to see its root pages, then into each page to see children.
Use a dedicated service account token rather than a personal token so the integration doesn’t break if a user leaves the organization.

GitHub

Setup

Create a personal access token with repo scope (or read:org for organization repositories), then click + Add connection next to GitHub in Configuration → Knowledge Base:
  1. Enter your Personal Access Token (classic ghp_ or fine-grained github_pat_)
  2. Give the connection a name and save

What You Can Import

Supported file types: .md, .txt, .docx
  • Repositories — Browse all repos accessible to your token
  • Directories — Navigate folder structures within a repo
  • Files — Import individual markdown, text, or Word documents

Browsing

The root level lists all repositories the token can access. Navigate into a repo to browse its directory structure and select files to import.
Fine-grained personal access tokens (github_pat_) scoped to specific repositories are recommended over classic tokens for tighter security.

Importing Content

Import from an external source when creating a new page in the Knowledge Base:
  1. In the Knowledge Base, click + to create a new page
  2. Select the GitHub, Confluence, or Notion tab at the top of the panel
  3. Choose a connection from the dropdown (or click + to add a new one)
  4. Browse the list of pages and select one — a preview loads on the right
  5. Choose an import mode and click to import
Import panel showing the Notion tab selected with a connection picker, page list, and markdown preview with Read & Write and Sync Only options

Import Modes

When importing, you choose how Orion handles the page going forward:
ModeBehaviour
Read & WriteImports the content as a normal Knowledge Base page. You can edit it freely, and manually sync from the source at any time.
Sync OnlyKeeps the page locked to the external source. Content updates automatically on a daily schedule — manual edits are not allowed.
Use Sync Only when the source is the authoritative version and you want the Knowledge Base to always reflect it. Use Read & Write when you want to import once and then own the content in Orion.

Syncing Pages

To refresh a Read & Write page with the latest content from its source:
  1. Open the page in the Knowledge Base editor
  2. Click Sync in the top toolbar
  3. The page content is overwritten with the current version from the source
Sync Only pages update automatically — no manual action required.
Syncing overwrites the page content entirely. Any manual edits made since the last sync will be lost.

Managing Integrations

From Configuration → Knowledge Base, each connection has three actions:
  • Rename (pencil icon) — change the display name of the connection
  • Browse (link icon) — open the integration browser to import more content
  • Delete (trash icon) — remove the connection. Pages already imported are kept, but they can no longer be synced.