Skip to content
CortexDocs

Connect Fibery to Cortex

Read workspace entities through a dedicated account API key.

Workplace connections

Fibery

Content and access

Account-visible non-system databases and entities. The account’s Space permissions determine access.

Before you begin

Use Cortex admin access and organization-wide connection requirements, plus these source-specific permissions:

Required

  • Fibery workspace access

    Use an account with access to the workspace you want to connect.

  • API key creation permission

    The account must be allowed to create Fibery API keys.

Optional

  • Dedicated service account

    Use a service account so the connection does not depend on one person.

Set up Fibery

  1. In Fibery, sign in as the account Cortex should read as.
  2. Share with that account only the Spaces that are safe for the whole Cortex organization. The key can read everything the account can see.
  3. In Fibery, open Settings → API Keys and create a key. Fibery allows three keys per account.
  4. In Cortex, open Organization → Apps and add Fibery. Enter the Workspace URL, for example yourcompany.fibery.io, and paste the key into API key. Once the URL is valid, Open API Keys in your workspace links straight to the key page.
  5. Select Connect, then Test & preview. The preview shows the account, the number of Spaces and databases it can read, and recent entities.

Fibery scope and limits

Each read-only connection covers one Fibery workspace. Cortex reads every database the account can see, except Fibery's built-in system databases, and syncs changes every hour. The first sync covers entities changed in the last 90 days.

For each entity, Cortex stores its name, the text of its first rich-text field (usually its description), its comments, workflow state, assignee, and a link back to Fibery. Entities deleted in Fibery are removed after a later sync. To connect a different workspace, delete the connection and add a new one.

Fibery account access is the security boundary: Cortex reads what the key's account can see. When you change that account's Space access in Fibery, return to Cortex and run Test & preview again.

Manage this connection

See the shared connection management guide for credential updates, reauthorization, and revocation.