Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Turbot Pipes

Scalekit connector
Open markdown

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

Tools
60
What they doRead · write · destructive
36 · 16 · 836 read16 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 Turbot Pipes connection

    In AgentKit > Connections, create a Turbot Pipes 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 = 'turbotpipes'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Turbot Pipes:', 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: 'turbotpipes_actor_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Turbot Pipes 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
  • turbotpipes_actor_getGet the Turbot Pipes user the API token belongs to.Read-only

    Get Current Actor

    Get the Turbot Pipes user the API token belongs to. Returns the user's ID, handle, display name, email and status. Use this to find your user handle for the identity_handle input.

    Inputs

    This tool takes no inputs.

  • turbotpipes_actor_orgs_listList the Turbot Pipes organizations the token's user belongs to.Read-only

    List My Orgs

    List the Turbot Pipes organizations the token's user belongs to. Returns org memberships with the org handle, display name and your role, plus next_token for paging. Use this to find org handles for the identity_handle input.

    Inputs

    limitinteger
    The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. Example: 25.
    next_tokenstring
    When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. Example: eyJpZCI6InNuYXBfY2c3bDFtNWQ0Y3ExcnI2ajFmaTAifQ.
  • turbotpipes_actor_workspaces_listList every Turbot Pipes workspace the token's user can access, across the user and all their orgs.Read-only

    List My Workspaces

    List every Turbot Pipes workspace the token's user can access, across the user and all their orgs. Returns workspaces with handle, owner identity, state and database details, plus next_token for paging. Use this to find a workspace across identities. Use turbotpipes_workspaces_list for one identity's workspaces.

    Inputs

    limitinteger
    The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. Example: 25.
    next_tokenstring
    When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. Example: eyJpZCI6InNuYXBfY2c3bDFtNWQ0Y3ExcnI2ajFmaTAifQ.
  • turbotpipes_audit_log_listList the audit log of a Turbot Pipes user or org.Read-only

    List Audit Logs

    List the audit log of a Turbot Pipes user or org. Returns audit entries with action type, actor, target, data and time, plus next_token for paging. Use this for who-did-what across an identity. Use turbotpipes_workspace_audit_log_list for one workspace.

    Inputs

    identity_handlestringrequired
    Handle of that user or org, as shown in Pipes URLs (pipes.turbot.com/org/<handle>). Use turbotpipes_actor_get for your user handle and turbotpipes_actor_orgs_list for org handles. Example: acme.
    identity_typestringrequired
    Whether the identity that owns the resource is a user (your personal identity) or an org. Example: org.one of userorg
    limitinteger
    The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. Example: 25.
    next_tokenstring
    When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. Example: eyJpZCI6InNuYXBfY2c3bDFtNWQ0Y3ExcnI2ajFmaTAifQ.
  • turbotpipes_connection_getGet one connection of a Turbot Pipes user or org.Read-only

    Get Connection

    Get one connection of a Turbot Pipes user or org. Returns the connection with handle, plugin, config (secrets masked) and timestamps. Use this for a connection's details.

    Inputs

    connection_handlestringrequired
    The handle of the connection whose detail needs to be fetched. Example: aws_prod.
    identity_handlestringrequired
    Handle of that user or org, as shown in Pipes URLs (pipes.turbot.com/org/<handle>). Use turbotpipes_actor_get for your user handle and turbotpipes_actor_orgs_list for org handles. Example: acme.
    identity_typestringrequired
    Whether the identity that owns the resource is a user (your personal identity) or an org. Example: org.one of userorg
  • turbotpipes_connection_testTest a plugin config for a Turbot Pipes user or org connection for basic connectivity, before you create or update the connection.Read-only

    Test Connection

    Test a plugin config for a Turbot Pipes user or org connection for basic connectivity, before you create or update the connection. Returns the test result with state and any error. Use this to check credentials. Use turbotpipes_connection_create to save the connection.

    Inputs

    connection_handlestringrequired
    The handle of the connection to be tested. For connections that are not yet created, use underscore _ as the handle, else pass the handle of the existing connection. Example: aws_prod.
    identity_handlestringrequired
    Handle of that user or org, as shown in Pipes URLs (pipes.turbot.com/org/<handle>). Use turbotpipes_actor_get for your user handle and turbotpipes_actor_orgs_list for org handles. Example: acme.
    identity_typestringrequired
    Whether the identity that owns the resource is a user (your personal identity) or an org. Example: org.one of userorg
    pluginstringrequired
    Steampipe plugin name, such as aws or github. Example: aws.
    configobject
    Plugin configuration to test, as a JSON object. Example: {"regions": ["us-east-1"], "access_key": "AKIAEXAMPLE", "secret_key": "example-secret"}
  • turbotpipes_connections_listList the connections (plugin credentials) of a Turbot Pipes user or org.Read-only

    List Connections

    List the connections (plugin credentials) of a Turbot Pipes user or org. Returns connections with handle, plugin, type and timestamps, plus next_token for paging. Use this for identity-level connections. Use turbotpipes_workspace_connections_list for a workspace's connections.

    Inputs

    identity_handlestringrequired
    Handle of that user or org, as shown in Pipes URLs (pipes.turbot.com/org/<handle>). Use turbotpipes_actor_get for your user handle and turbotpipes_actor_orgs_list for org handles. Example: acme.
    identity_typestringrequired
    Whether the identity that owns the resource is a user (your personal identity) or an org. Example: org.one of userorg
    limitinteger
    The max number of items to fetch per page of data, subject to a min and max of 1 and 100 respectively. If not specified will default to 25. Example: 25.
    next_tokenstring
    When list results are truncated, next_token will be returned, which is a cursor to fetch the next page of data. Pass next_token to the subsequent list request to fetch the next page of data. Example: eyJpZCI6InNuYXBfY2c3bDFtNWQ0Y3ExcnI2ajFmaTAifQ.