Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Fullstory

Scalekit connector
Open markdown

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

Tools
30
What they doRead · write · destructive
19 · 9 · 219 read9 write2 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 Fullstory connection

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

    Each user opens the link once and enters their Fullstory 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
  • fullstory_events_batch_import_errors_listList the events that failed in a batch event import job, one page at a time.Read-only

    List Event Batch Import Errors

    List the events that failed in a batch event import job, one page at a time. Returns each failed event with an error code and message, plus next_page_token. Use this after fullstory_events_batch_import_get reports failures.

    Inputs

    job_idstringrequired
    The batch event import job ID returned by fullstory_events_batch_import_create. Example: MTI4NjYxNjM0MjM1NzQ0MzQ5OA.
    page_tokenstring
    Token for the next page, from the next_page_token of the previous fullstory_events_batch_import_errors_list response. Leave empty for the first page.
  • fullstory_events_batch_import_getGet the status of a batch event import job.Read-only

    Get Event Batch Import Status

    Get the status of a batch event import job. Returns the job (id, status, created and finished times) and the counts of imported events and errors. Use this to poll a job from fullstory_events_batch_import_create.

    Inputs

    job_idstringrequired
    The batch event import job ID returned by fullstory_events_batch_import_create. Example: MTI4NjYxNjM0MjM1NzQ0MzQ5OA.
  • fullstory_events_batch_imports_listList the events imported successfully by a batch event import job, one page at a time.Read-only

    List Event Batch Import Results

    List the events imported successfully by a batch event import job, one page at a time. Returns each imported event's details, plus next_page_token. Use this to confirm which events landed after a batch import.

    Inputs

    job_idstringrequired
    The batch event import job ID returned by fullstory_events_batch_import_create. Example: MTI4NjYxNjM0MjM1NzQ0MzQ5OA.
    include_schemaboolean
    Set to true to include the property type schema in the response. Defaults to false.
    page_tokenstring
    Token for the next page, from the next_page_token of the previous fullstory_events_batch_imports_list response. Leave empty for the first page.
  • fullstory_me_getCheck the connected Fullstory API key.Read-only

    Get API Key Info

    Check the connected Fullstory API key. Returns the key's orgId, the email of the user it belongs to, its role (USER for Standard, ARCHITECT or ADMIN) and scopes. Use this to test the connection or to see whether the key can call Architect-level tools.

    Inputs

    This tool takes no inputs.

  • fullstory_operation_getGet the status of one Fullstory background operation, such as a segment export or user deletion.Read-only

    Get Operation

    Get the status of one Fullstory background operation, such as a segment export or user deletion. Returns the operation's type, state (PENDING, COMPLETED or FAILED), estimated percent complete, errorDetails and results; a completed export's results hold its searchExportId and expiry. Use this to poll an operation. Use fullstory_search_export_results_get to download a completed export.

    Inputs

    idstringrequired
    The operation ID, for example the operationId returned by fullstory_segment_export_create. Example: 4b1c8f2e-0f3d-4c8b-9a7e-2d5f6c1b3a90.
  • fullstory_operations_listList Fullstory's background operations (exports and deletions), ongoing and completed, optionally by state or type.Read-only

    List Operations

    List Fullstory's background operations (exports and deletions), ongoing and completed, optionally by state or type. Returns each operation's id, type, state, estimated percent complete, results and timestamps, plus nextPaginationToken. Use this to find recent exports or deletions. Use fullstory_operation_get for one operation.

    Inputs

    limitinteger
    Maximum number of operations to return, up to 100 (the default).
    paginationTokenstring
    Token for the next page, from the previous fullstory_operations_list response. Keep the other filters the same between pages.
    statestring
    Only return operations in this state.one of PENDINGCOMPLETEDFAILED
    typestring
    Only return operations of this type.one of DELETE_USERSEARCH_EXPORTDELETE_SESSIONDELETE_SEGMENT_SESSIONSDELETE_SEGMENT_USERS
  • fullstory_quotas_getGet the Fullstory organization's quota usage, including session and server event quotas.Read-only

    Get Quotas

    Get the Fullstory organization's quota usage, including session and server event quotas. Returns each quota with its limit, usage and period. Use this before large imports to check remaining capacity.

    Inputs

    This tool takes no inputs.

  • fullstory_search_export_results_getGet a temporary download URL for a completed, unexpired segment export.Read-only

    Get Export Download Link

    Get a temporary download URL for a completed, unexpired segment export. Needs an Architect or Admin API key. Returns location, a temporary URL to download the exported file, and when it expires. Use this after fullstory_operation_get shows the export COMPLETED; pass the searchExportId from its results.

    Inputs

    idstringrequired
    The searchExportId from the results of a completed SEARCH_EXPORT operation. Example: 4f2c6d9a-1b3e-4c5d-8e7f-0a1b2c3d4e5f.