Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Rootly

Scalekit connector
Open markdown

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

Tools
110
What they doRead · write · destructive
73 · 34 · 373 read34 write3 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 Rootly connection

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

    Each user opens the link once and enters their Rootly 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
  • rootly_get_action_itemRetrieve an incident action item.Read-only

    Get Action Item

    Retrieve an incident action item. Returns the incident_action_item record with id, type and attributes (summary, description, kind, assigned_to, assigned_to_group_ids, priority). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
  • rootly_get_alertRetrieve an alert.Read-only

    Get Alert

    Retrieve an alert. Returns the alert record with id, type and attributes (short_id, noise, source, status, summary, description). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
    includestring
    comma separated if needed. eg: environments,services,groups Comma-separated list of related resources to include: environments, services, groups, functionalities, responders, incidents, notified_users, events, alert_urgency, heartbeat, live_call_router, alert_group, group_leader_alert, group_member_alerts, alert_field_values, alerting_targets, escalation_policies, alert_call_recording. Example: services,environments.
  • rootly_get_alert_groupRetrieve an alert group.Read-only

    Get Alert Group

    Retrieve an alert group. Returns the alert_group record with id, type and attributes (name, description, slug, condition_type, time_window, group_by_alert_title). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
  • rootly_get_alert_routeGet an alert route.Read-only

    Get Alert Route

    Get an alert route. Returns the alert_route record with id, type and attributes (name, enabled, alerts_source_ids, owning_team_ids, rules). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
    show_nested_idsboolean
    Include the IDs of nested destinations, condition groups and conditions, for referencing them in PATCH updates or deletions. Example: true.
  • rootly_get_alert_sourceRetrieve an alert source.Read-only

    Get Alert Source

    Retrieve an alert source. Returns the alert_source record with id, type and attributes (name, enabled, source_type, alert_urgency_id, deduplicate_alerts_by_key, deduplication_key_kind). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
  • rootly_get_alert_urgencyRetrieve an alert urgency.Read-only

    Get Alert Urgency

    Retrieve an alert urgency. Returns the alert_urgencie record with id, type and attributes (name, description, position, retrigger_timeout_minutes, urgency, color). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
  • rootly_get_catalogRetrieve a catalog.Read-only

    Get Catalog

    Retrieve a catalog. Returns the catalog record with id, type and attributes (name, slug, description, icon, position, external_id). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
  • rootly_get_catalog_entityRetrieve a Catalog Entity.Read-only

    Get Catalog Entity

    Retrieve a Catalog Entity. Returns the catalog_entitie record with id, type and attributes (name, slug, description, public_description, position, backstage_id). Use it when the id is known; use the matching list tool to find ids or filter.

    Inputs

    idstringrequired
    The UUID or slug of the target record, as returned by the matching list tool. Example: a1b2c3d4-e5f6-4789-a012-3456789abcde.
    includestring
    comma separated if needed. eg: catalog,properties Comma-separated list of related resources to include: catalog, properties. Example: services,environments.