Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Bika AI

Scalekit connector
Open markdown

The Bika AI connector lets your AI agent act in each user's Bika AI account. Each user connects their own Bika AI access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 35 tools.

Tools
35
What they doRead · write · destructive
18 · 9 · 818 read9 write8 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Bika AI connection

    In AgentKit > Connections, create a Bika AI connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'bika'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Bika AI:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'bika_spaces_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Bika AI credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • bika_automation_triggers_listList the triggers of an automation.Read-only

    List Automation Triggers

    List the triggers of an automation. Returns success, code, message and data with the automation's triggers. Use bika_nodes_list to find automation IDs.

    Inputs

    automation_idstringrequired
    ID of the automation (starts with ato), from bika_nodes_list. Example: atoA1b2C3d4E5.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_database_fields_listList a database's fields (columns).Read-only

    List Database Fields

    List a database's fields (columns). Returns success, code, message and data with the database's fields. Use field names or ids as keys in bika_records_create and bika_record_update.

    Inputs

    database_idstringrequired
    ID of the database (starts with dat; same as its node ID), from bika_nodes_list or the database URL. Example: datJubyEnetNFd3UQ6gSeq7U.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_database_getGet a database's definition.Read-only

    Get Database

    Get a database's definition. Returns success, code, message and data with the database definition. Use bika_database_fields_list for field types before writing records.

    Inputs

    database_idstringrequired
    ID of the database (starts with dat; same as its node ID), from bika_nodes_list or the database URL. Example: datJubyEnetNFd3UQ6gSeq7U.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_database_views_listList a database's views.Read-only

    List Database Views

    List a database's views. Returns success, code, message and data with the database's views. Use this to understand how the database is organized.

    Inputs

    database_idstringrequired
    ID of the database (starts with dat; same as its node ID), from bika_nodes_list or the database URL. Example: datJubyEnetNFd3UQ6gSeq7U.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_member_getGet one member of a space.Read-only

    Get Member

    Get one member of a space. Returns success, code, message and data with the member's details. Use bika_team_members_list to find member IDs.

    Inputs

    member_idstringrequired
    ID of the space member. Example: mebA1b2C3d4.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_node_getGet one node resource in a space.Read-only

    Get Node Resource

    Get one node resource in a space. Returns success, code, message and data with the node resource. Use bika_database_get for database details.

    Inputs

    node_idstringrequired
    ID of the node resource, from bika_nodes_list. Example: datJubyEnetNFd3UQ6gSeq7U.
    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.
  • bika_nodes_listList the node resources in a space: databases, automations, dashboards, documents, folders and AI agents.Read-only

    List Node Resources

    List the node resources in a space: databases, automations, dashboards, documents, folders and AI agents. Returns success, code, message and data with the space's node resources (id, name and type). Use node IDs with bika_node_get; a database's node ID is its database ID.

    Inputs

    space_idstringrequired
    ID of the space (starts with spc), from bika_spaces_list or the space URL. Example: spcND68gdMMZBmGK67gvqNVX.